创建对话 - CreateChat
功能介绍
创建对话。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/chats
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目ID,您可以从获取项目ID中获取。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-128]个字符。 默认取值: 不涉及 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Chat-Route-Id | 是 | String | 参数解释: 对话路由ID。 约束限制: 不涉及 取值范围: 仅支持字母、数字、中划线和下划线,长度为[1-64]个字符。 默认取值: 不涉及 |
X-Auth-Token | 是 | String | 参数解释: 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及 取值范围: 长度为[1-32768]个字符。 默认取值: 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
id | 否 | String | 参数解释: 对话ID。 约束限制: 不填值表示新建对话的首次问答,填值表示在原有对话下新增问答。 取值范围: 仅支持字母、数字、中划线和下划线,长度为[0-128]个字符。 默认取值: 不涉及 |
message | 是 | String | 参数解释: 对话消息。 约束限制: 不涉及 取值范围: 取值范围为[1-16384]个字符。 默认取值: 不涉及 |
agent_type | 是 | String | 参数解释: 助手类型。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
agent_role | 否 | String | 参数解释: 助手角色。 约束限制: 不涉及 取值范围:
默认取值: Common |
enable_deepresearch | 否 | Boolean | 参数解释: 是否开启深度探究。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
chat_id | String | 参数解释: 对话ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
id | String | 参数解释: 问答ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
create_time | String | 参数解释: 问答创建时间。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
type | String | 参数解释: 问答类型。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
message | ChatMessage object | 参数解释: 对话内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 | 参数类型 | 描述 |
|---|---|---|
content | String | 参数解释: 对话内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
reasoning_content | String | 参数解释: 深度搜索思维链内容。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
tool_calls | Array of ToolCall objects | 参数解释: 工具调用列表。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求示例
创建对话,通用类型助手,助手角色为对话助手。
https://{endpoint}/v1/{project_id}/chats
{
"message" : "This is a question.",
"agent_type" : "auto",
"agent_role" : "Common"
} 响应示例
状态码:200
OK
成功创建对话。
{
"chat_id" : "7275cb0f-e35d-48a6-9ecc-2d0a3398f3c8",
"id" : "8b843dc9-8ecc-4a48-8ee4-95185d066c17",
"create_time" : "2025-09-11T06:32:41Z",
"type" : "chat_call",
"message" : {
"content" : "This is a answer",
"tool_calls" : [ ]
}
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
错误码
请参见错误码。

