价格
- 按 Token 后付费，20 元/百万 Tokens
- 计量范围：智能体全任务流节点产生的 Tokens 总数
接口请求
| 传输方式 | https |
|---|---|
| 请求地址 | https://open.bigmodel.cn/api/v1/agents |
| 调用方式 | 同步调用，等待模型完成执行并返回最终结果或使用SSE调用 |
| 字符编码 | UTF-8 |
| 接口请求格式 | JSON |
| 响应格式 | JSON 或标准 Stream Event |
| 接口请求类型 | POST |
| 开发语言 | 任意可发起 http 请求的开发语言 |
请求参数
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| agent_id | String | 是 | 智能体 ID：general_translation |
| stream | Boolean | 否 | 使用同步调用时，此参数应当设置为 fasle 或者省略。表示模型生成完所有内容后一次性返回所有内容。默认值为 false。 如果设置为 true，模型将通过标准 Event Stream ，逐块返回模型生成内容。Event Stream 结束时会返回一条data: [DONE]消息。 注意：在模型流式输出生成内容的过程中，我们会分批对模型生成内容进行检测，当检测到违法及不良信息时，API会返回错误码（1301）。开发者识别到错误码（1301），应及时采取（清屏、重启对话）等措施删除生成内容，并确保不将含有违法及不良信息的内容传递给模型继续生成，避免其造成负面影响 |
| messages | List<Object> | 是 | 会话消息体 |
| └─ role | String | 是 | 用户的输入 role = user |
| content | List<Object> | 是 | 会话消息体 |
| └─ type | String | 是 | 目前支持 type=text |
| └─ text | String | 是 | 用户输入的文本内容 |
| custom_variables | Object | 否 | 智能体扩展参数 |
| └─ source_lang | String | 否 | 待翻译文本的源语言代码，默认值为 auto。可选值：• auto（自动检测语种）• 其他语种列表：详见语种代码表 |
| └─ target_lang | String | 否 | 待翻译文本的目标语言代码，默认为 zh。可选值：• zh（中文）• 其他语种列表：详见语种代码表 |
| └─ glossary | String | 否 | 术语表id，即通过文件上传接口获取的 file_id |
| └─ strategy | String | 否 | 翻译策略，默认 general。可选值：• general（通用翻译）• paraphrase（转述翻译）• two_step（两步翻译）• three_step（三步翻译）• reflection（反思翻译）• cot（COT翻译） |
| └─ strategy_config | Object | 否 | 翻译策略对应的参数 |
| └─ general | Object | 否 | 当翻译策略指定为 general 时生效 |
| └─ suggestion | String | 否 | 翻译建议或风格要求，如术语对照、文体规范等 |
| └─ cot | Object | 否 | 当翻译策略指定为 cot 时生效 |
| └─ reason_lang | String | 否 | 翻译理由的语言，取值 from 或 to，默认 to |
响应内容
| 参数名称 | 类型 | 参数说明 |
|---|---|---|
| id | String | 任务 ID |
| agent_id | String | 智能体 ID |
| choices | List | 当前对话的模型输出内容 |
| index | Integer | 结果下标 |
| finish_reason | String | 模型推理终止的原因。枚举值： • stop（推理自然结束或触发停止词）• tool_calls（模型命中函数）• length（到达 tokens 长度上限）• sensitive（模型推理内容被安全审核接口拦截，请用户自行判断并决定是否撤回已公开的内容）• network_error（模型推理异常） |
| message | Object | 模型返回的文本信息 |
| └─ role | String | 当前对话的角色，目前默认为 assistant（模型） |
| content | Object | 当前对话的推理结果。 |
| └─ type | String | 当前对话的推理结果类型 |
| └─ text | String | 当前对话的推理结果内容 |
| usage | Object | 模型调用结束时返回的 tokens 使用统计。 |
| └─ prompt_tokens | Integer | 用户输入的 tokens 数量 |
| └─ completion_tokens | Integer | 模型输出的 tokens 数量 |
| └─ total_tokens | Integer | 总 tokens 数量 |
支持的语种列表
- 源语言列表
| 语言代码 | 中文名称 |
|---|---|
| auto | 自动检测 |
| zh-CN | 简体中文 |
| zh-TW | 繁体中文 |
| wyw | 文言文 |
| yue | 粤语 |
| en | 英语 |
| ja | 日语 |
| ko | 韩语 |
| fr | 法语 |
| de | 德语 |
| es | 西班牙语 |
| ru | 俄语 |
| pt | 葡萄牙语 |
| it | 意大利语 |
| ar | 阿拉伯语 |
| hi | 印地语 |
| bg | 保加利亚语 |
| cs | 捷克语 |
| da | 丹麦语 |
| el | 希腊语 |
| et | 爱沙尼亚语 |
| fi | 芬兰语 |
| hu | 匈牙利语 |
| id | 印尼语 |
| lt | 立陶宛语 |
| lv | 拉脱维亚语 |
| nl | 荷兰语 |
| no | 书面挪威语 |
| pl | 波兰语 |
| ro | 罗马尼亚语 |
| sk | 斯洛伐克语 |
| sl | 斯洛文尼亚语 |
| sv | 瑞典语 |
| th | 泰语 |
| tr | 土耳其语 |
| uk | 乌克兰语 |
| vi | 越南语 |
| my | 缅甸语 |
| ms | 马来语 |
| Pinyin | 拼音 |
| IPA | 国际音标 |
- 目标语言列表
| 语言代码 | 中文名称 |
|---|---|
| zh-CN | 简体中文 |
| zh-TW | 繁体中文 |
| wyw | 文言文 |
| yue | 粤语 |
| en | 英语 |
| en-GB | 英语（英国） |
| en-US | 英语（美国） |
| ja | 日语 |
| ko | 韩语 |
| fr | 法语 |
| de | 德语 |
| es | 西班牙语 |
| ru | 俄语 |
| pt | 葡萄牙语 |
| it | 意大利语 |
| ar | 阿拉伯语 |
| hi | 印地语 |
| bg | 保加利亚语 |
| cs | 捷克语 |
| da | 丹麦语 |
| el | 希腊语 |
| et | 爱沙尼亚语 |
| fi | 芬兰语 |
| hu | 匈牙利语 |
| id | 印尼语 |
| lt | 立陶宛语 |
| lv | 拉脱维亚语 |
| nl | 荷兰语 |
| no | 书面挪威语 |
| pl | 波兰语 |
| ro | 罗马尼亚语 |
| sk | 斯洛伐克语 |
| sl | 斯洛文尼亚语 |
| sv | 瑞典语 |
| th | 泰语 |
| tr | 土耳其语 |
| uk | 乌克兰语 |
| vi | 越南语 |
| my | 缅甸语 |
| ms | 马来语 |
| Pinyin | 拼音 |
| IPA | 国际音标 |