# 创建对话 - CreateChat #### 功能介绍 创建对话。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0100.html)。 #### URI POST /v1/{project_id}/chats 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0033.html)中获取。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-128\]个字符。 **默认取值**： 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Chat-Route-Id | 是 | String | **参数解释**： 对话路由ID。 **约束限制**： 不涉及 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[1-64\]个字符。 **默认取值**： 不涉及 | | X-Auth-Token | 是 | String | **参数解释**： 用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-ai4sservice/ai4sservice_03_0011.html)接口响应消息头中X-Subject-Token的值即为Token。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]个字符。 **默认取值**： 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | String | **参数解释**： 对话ID。 **约束限制**： 不填值表示新建对话的首次问答，填值表示在原有对话下新增问答。 **取值范围**： 仅支持字母、数字、中划线和下划线，长度为\[0-128\]个字符。 **默认取值**： 不涉及 | | message | 是 | String | **参数解释**： 对话消息。 **约束限制**： 不涉及 **取值范围**： 取值范围为\[1-16384\]个字符。 **默认取值**： 不涉及 | | agent_type | 是 | String | **参数解释**： 助手类型。 **约束限制**： 不涉及 **取值范围**： - auto：通用助手 - drug：药物助手 - gene：基因助手 **默认取值**： 不涉及 | | agent_role | 否 | String | **参数解释**： 助手角色。 **约束限制**： 不涉及 **取值范围**： - Common：对话助手角色 - Biomed：作业助手角色 **默认取值**： Common | | enable_deepresearch | 否 | Boolean | **参数解释**： 是否开启深度探究。 **约束限制**： 不涉及 **取值范围**： - true：开启深度探究 - false：关闭深度探究 **默认取值**： 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | chat_id | String | **参数解释**： 对话ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | id | String | **参数解释**： 问答ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | create_time | String | **参数解释**： 问答创建时间。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | type | String | **参数解释**： 问答类型。 **约束限制**： 不涉及 **取值范围**： - chat_call：普通问答 - tool_call：实验问答 - deepresearch_call：深度探究 **默认取值**： 不涉及 | | message | [ChatMessage] object | **参数解释**： 对话内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表5ChatMessage | 参数 | 参数类型 | 描述 | |:---|:---|:---| | content | String | **参数解释**： 对话内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | reasoning_content | String | **参数解释**： 深度搜索思维链内容。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | tool_calls | Array of [ToolCall] objects | **参数解释**： 工具调用列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表6ToolCall | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释**： 工具类型。 **约束限制**： 不涉及 **取值范围**： - drug_job：药物作业 - workflow：流程作业 **默认取值**： 不涉及 | | name | String | **参数解释**： 工具名称。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | operation | String | **参数解释**： 工具操作。 **约束限制**： 不涉及 **取值范围**： - create：新增 - delete：删除 - update：修改 - query：查询 **默认取值**： 不涉及 | | parameters | Map\ | **参数解释**： 工具调用所需参数列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 请求示例 创建对话，通用类型助手，助手角色为对话助手。 ``` 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ai4sservice/ErrorCode.html)。