执行会话

1. 接口描述

接口请求域名： hunyuan.tencentcloudapi.com 。

腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。

1. 本接口暂不支持返回图片内容。
2. 默认该接口下单账号限制并发数为 5 路，如您有提高并发限制的需求请 购买 。
3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。SDK 链接在文档下方 “开发者资源 - SDK” 部分提供。
4. 我们推荐您使用 API Explorer，方便快速地在线调试接口和下载各语言的示例代码，点击打开。

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 执行会话

执行会话

输入示例

POST / HTTP/1.1
Host: hunyuan.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: RunThread
<公共请求参数>

{
    "ThreadID": "thread_zqkehzQBog4v4lJxBPQRXtYW",
    "Model": "hunyuan-pro",
    "AdditionalMessages": [
        {
            "Role": "user",
            "Content": "你是谁"
        }
    ],
    "Stream": true
}

输出示例

{
    "ID": "run_cRpe4PGgXxTwwvuee55anOO4",
    "Object": "thread.run",
    "CreatedAt": 1727355339,
    "ThreadID": "thread_zqkehzQBog4v4lJxBPQRXtYW",
    "AssistantID": "",
    "Status": "created",
    "RequiredAction": null,
    "LastError": null,
    "ExpiresAt": 0,
    "StartedAt": 0,
    "CancelledAt": 0,
    "FailedAt": 0,
    "CompletedAt": 0,
    "InCompleteDetails": null,
    "Model": "hunyuan",
    "Instructions": "",
    "Tools": [],
    "Metadata": {},
    "Usage": null,
    "Temperature": 0,
    "TopP": 0,
    "MaxPromptTokens": 0,
    "MaxCompletionTokens": 0,
    "TruncationStrategy": {
        "Type": "",
        "LastMessages": null
    },
    "ParallelToolCalls": false,
    "ResponseFormat": null
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。