第三方模型对接规范
更新时间:2025-12-09
概述
使用自有对话大模型,可以按此规范提供一个开放接口,在平台上配置机器人的调用地址、授权token、模型,通过机器人对话会触发此接口的调用。
要求
- 模型提供openAPI格式的接口协议
请求参数
Header参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Content-Type | string | 是 | 内容类型,固定值:application/json |
| Authorization | string | 是 | 鉴权信息,Bearer AK |
| sessionid | string | 否 | 通话ID |
| taskmemberid | string | 否 | 任务ID |
| extjson | string | 否 | 扩展信息,json字符串 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
| messages | array | 是 | 对话信息 |
| → role | string | 是 | 对话角色,默认 user 用户 |
| → content | string | 是 | 上下文信息 |
| stream | bool | 是 | 交互模型,true流式,false非流式,默认为true |
请求示例
JSON
1curl -X POST 'https://qianfan.baidubce.com/v2/chat/completions' \
2 -H 'sessionid: xxx' \
3 -H 'taskmemberid: xxx' \
4 -H 'extjson: xxx' \
5 -H 'Content-Type: application/json' \
6 -H 'Authorization: Bearer bce-v3/ALTAK-*****************/2d7*****************' \
7 -d '{
8 "model": "ernie-3.5-8k",
9 "messages": [
10 {
11 "role": "user",
12 "content": "
13 #### 角色设定 ####\n\n
14 电话营销人员通过游戏社交群为切入点,与目标用户建立初步联系,并且实时转人工对接跟进,实现从陌生人到社交平台好友的转化。\n\n
15 #### 背景信息 ####\n\n
16 今天是2025-08-06 星期三\n现在时间是: 19:47:47\n\n
17 #### 参考问答对 #### \n
18 问答:\n标准答复:\n\n
19 #### 上下文 ####\n
20 坐席:喂,哈喽,xxx?\n
21 客户:嗯,再见\n\n\n
22 请根据###参考问答对###的标准答复及上下文给出回复\n\n
23 #### RESPONSE(响应)####\n
24 坐席:"
25 }
26 ],
27 "stream": true
28 }
响应参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| id | string | 是 | 请求ID |
| model | string | 是 | 模型名称 |
| object | string | 是 | 对象类型 |
| creted | int | 是 | 创建时间 |
| choices | array | 是 | 选择项列表 |
| → index | int | 是 | 索引 |
| → delta | object | 是 | 响应信息 |
| → → content | string | 是 | 对话内容 |
| → finish_reason | string | 是 | 完成原因,stop(结束) |
响应示例
JSON
1{"choices":[{"delta":{"content":"您方便时回"},"finish_reason":null,"index":0}],"object":"chat.completion.chunk","created":1754480884,"model":"xxx","id":"as-xxx"}
2{"choices":[{"delta":{"content":"个信吧,"},"finish_reason":null,"index":0}],"object":"chat.completion.chunk","created":1754480884,"model":"xxx","id":"as-xxx"}
3{"choices":[{"delta":{"content":"再见。"},"finish_reason":null,"index":0}],"object":"chat.completion.chunk","created":1754480884,"model":"xxx","id":"as-xxx"}
4{"choices":[{"delta":{"content":""},"finish_reason":"stop","index":0}],"object":"chat.completion.chunk","created":1754480884,"model":"xxx","id":"as-xxx"}
5[DONE]
