接口URL:/aipaas/algo/v1/telechat3-438b-a24b/v1/chat/completions
建立连接时的请求头部
| 头部标签 | 必填 | 示例 | 说明 |
|---|---|---|---|
| Content-Type | 是 | application/json | application/json;UTF-8 |
| X-APP-ID | 是 | 控制台--应用管理--AppID | |
| Device-Uuid | 否 | 设备管理-设备uuid | |
| Authorization | 是 | 鉴权信息 |
一、OpenAI协议调用示例
curl --location 'XXXXXXXXXXXXXXXXXXXXXXX/v1/chat/completions' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data '{
"model": "TeleChat3-438B-A24B",
"messages": [
{
"role": "user",
"content": "今天天气"
}
],
"stream": true,
"chat_template_kwargs": {
"enable_thinking": true
},
"stream_options": {
"include_usage": true
}
}'
备注:
(1)深度思考模型:"chat_template_kwargs": {"enable_thinking": true}
(2)多轮对话场景:请传入"session-id"字段,确保不同session传入不同session-id
带session-id的调用形式:
curl --location 'XXXXXXXXXXXXXXXXXXXXXXX/v1/chat/completions' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'session-id: 989fdsaf73qt0dsgfds' \
--header 'Content-Type: application/json' \
--data '{
"model": "TeleChat3-438B-A24B",
"messages": [
{
"role": "user",
"content": "今天天气"
}
],
"stream": true,
"chat_template_kwargs": {
"enable_thinking": true
},
"stream_options": {
"include_usage": true
}
}'
(3)用户传Traceid使用说明:
Trace Contexttraceid 的传 需要符合标准的W3C协议:Trace Context
符合 W3C Trace Context 标准时,traceid 通过 traceparent Header 传递,格式:
traceparent: {version}-{trace-id}-{parent-id}-{flags},字段含义如下:
| 字段 |
示例值 |
说明 |
|---|---|---|
| version |
00 |
W3C 版本号,基本不修改,默认00即可 |
| trace-id |
0af7651916cd43dd8448eb211c80319c |
32 位六进制,整条链路唯一ID |
| parent-id |
b7ad6b7169203331 |
16 位六进制,当前请求spanID |
| flags |
01 |
默认值01即可 |
带traceid的调用形式:
curl --location 'XXXXXXXXXXXXXXXXXXXXXXX/v1/chat/completions' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'traceparent:
00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-
01' \
--header 'Content-Type: application/json' \
--data '{
"model": "TeleChat3-438B-A24B",
"messages": [
{
"role": "user",
"content": "今天天气"
}
],
"stream": true,
"chat_template_kwargs": {
"enable_thinking": true
},
"stream_options": {
"include_usage": true
}
}'
二、OpenAI协议接口文档
用户可直接参考以下文档进行接口对接:(https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)