¶ 大模型知识库问答接口
¶ 请求规范
host
headers
Content-Type: application/json
Authorization: Bearer {token}
token 获取
获取token，可以通过聆思大模型平台密钥管理页面生成。注意token生成完妥善保管。
¶ 对话接口
POST /v1/knowledge-chat/:app_id/chat/completions
¶ 对话接口获取
1、在聆思平台点击我的应用
2、点击要接入的应用
3,、在应用设计页面点击应用接入，即可看到api地址
请求路径参数
| 名称 | 类型 | 说明 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| app_id | string | 大模型知识库问答应用ID | 是 | - |
请求参数
| 名称 | 类型 | 说明 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| messages | Array<message> | 会话和提问 | 是 | - | 需要自行拼接对话历史信息，数组最后是最新的用户提问 |
| message.role | string | 角色 | 是 | - | 可取值： user，assistant ；其中user表示用户的提问，assistant表示AI的回复 ; 若当前message为messages数组的最后一个元素，role的值需为字符串'user' |
| message.content | string | 文本内容 | 是 | - | 该角色的对话内容 |
| images | Array<image> | 图片内容 | 否 | - | - |
| image | url | 图片 | 否 | - | 支持http url和base64图片内容 |
请求示例
curl --request POST \
--url https://api.listenai.com/v1/knowledge-chat/:app_id/chat/completions \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${token}' \
--data '{
"messages": [
{
"role": "user",
"content": "空调中的净化效率是怎么定义的？"
}
]
}'
流式输出
data: {"choices":[{"delta":{"content":"","documents":["家用和类似用途电器的抗菌 除菌 净化功能 空调器的特殊要求-GB-21551.6-2010.pdf","家用和类似用途电器的抗菌 除菌 净化功能 电冰箱的特殊要求-GB-21551.4-2010.pdf"],"role":"meta"},"index":0}],"created":1742370307,"id":"","model":"","service_tier":"default","object":"chat.completion.chunk","usage":null}
data: {"choices":[{"delta":{"content":"","reasoning_content":"模型推理内容","role":"assistant"},"index":0}],"created":1743151916,"id":"0217431519076954ee2a242cadeb3c7acc981f0bd805884b29e9b","model":"deepseek-r1-250120","service_tier":"default","object":"chat.completion.chunk","usage":null}
data: {"choices":[{"delta":{"content":"模型回复内容","role":"assistant"},"finish_reason":"stop","index":0}],"created":1743151916,"id":"0217431519076954ee2a242cadeb3c7acc981f0bd805884b29e9b","model":"deepseek-r1-250120","service_tier":"default","object":"chat.completion.chunk","usage":null}
data: {"choices":[{"delta":{"content":"\n【答案链接】：<a href=\"https://platform.listenai.com/answer?id=dfc4a366-feb8-4e2f-b327-c204937eaabd\" target=\"_blank\">点击打开</a>","role":"assistant"},"index":0}],"created":1743151916,"id":"0217431519076954ee2a242cadeb3c7acc981f0bd805884b29e9b","model":"deepseek-r1-250120","service_tier":"default","object":"chat.completion.chunk","usage":null}
data: [DONE]
回复参数
| 名称 | 类型 | 说明 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| documents | array | 召回文档列表 | 否 | - | - |
| content | string | 模型回复内容 | 是 | - | - |