模型对话调用(Completions)
POST
/v1/chat/completions请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Authorization
string
必需
示例值:
Bearer {{token}}
Body 参数application/json
model
string
模型
可取值:spark-general-1.5: 基础模型v1.5版本; spark-general-2.0: 基础模型v2.0版本; spark-interface-1.0: 交互模型(支持技能),需配合plugins字段使用
uid
string
用户id,一个代表你的最终用户的唯一标识符
字符串最大长度为32
auditing
string
内容审核的场景策略
可取值: default
domain
string
需要使用的领域
可取值: general
temperature
核采样阈值
最小值是0.1,最大值是1
top_k
从k个中随机选择一个(非等概率)
最小值是1,最大值是6
max_tokens
回答的tokens的最大长度
最小值是1,最大值是4096;基础模型v2.0版本的最大值是8192
stream
boolean
是否支持流式
plugins
array[string]
插件
当model为'spark-interface-1.0'时,该字段生效,用于指定可用技能,当前数组可填值:'天气'、'菜谱'
location
object
位置
在使用某些技能时会生效
latitude
number
纬度
GPS坐标纬度
longitude
number
经度
GPS坐标经度
messages
array [object {2}]
会话和提问
需要自行拼接对话历史信息,数组最后是最新的用户提问
role
string
角色
可取值: user,assistant ;其中user表示用户的提问,assistant表示AI的回复 ; 若当前message为messages数组的最后一个元素,role的值需为字符串'user'
content
string
文本内容
该角色的对话内容
示例
{
"temperature": 0.5,
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "广州有什么东西玩,十个字内回复"
}
]
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
choices
array [object {3}]
必需
finish_reason
null
可选
index
integer
可选
message
object
可选
created
integer
必需
id
string
必需
object
string
必需
usage
object
必需
completion_tokens
integer
必需
prompt_tokens
integer
必需
question_tokens
integer
必需
total_tokens
integer
必需
示例
基础模型请求示例
{
"choices": [
{
"finish_reason": null,
"index": 0,
"message": {
"content": "广州有很多值得玩的地方,比如珠江夜游、白云山、荔枝湾等。此外,广州还有丰富的美食文化和购物场所,例如北京路步行街和天河城购物中心。",
"role": "assistant"
}
}
],
"created": 1683804700,
"id": "cht000d6b4f@dx1880a94b87ab894540",
"object": "chat.completion",
"usage": {
"completion_tokens": 44,
"prompt_tokens": 8,
"question_tokens": 7,
"total_tokens": 52
}
}
修改于 1 年前