创建文本对话请求
Creates a model response for the given chat conversation.
POST
https://api.openapi.cn/v1/chat/completions
认证参数
Authorization
string
header
必填
使用以下格式进行身份验证:Bearer <YOUR API KEY>
请求体
application/json
model
string
必填
对应的模型名称。为了更好地提升服务质量,我们将对本服务提供的模型进行定期变更,包括但不限于模型上下线、模型服务能力调整等,在可行的情况下,我们将通过公告、消息推送等适当方式通知您相关变更。
messages
array
必填
到目前为止组成对话的消息列表
stream
boolean
可选
如果设置,令牌将在可用时作为服务器发送的事件返回。流以 data: [DONE] 终止
max_tokens
integer
可选
生成的最大令牌数
stop
string
可选
最多4个序列,API将停止生成更多令牌。返回的文本不会包含停止序列
temperature
number
可选
确定响应中的随机程度
top_p
number
可选
top_p(核)参数用于根据累积概率动态调整每个预测令牌的选择数量
top_k
number
可选
控制每一步考虑的最高概率词汇数量
frequency_penalty
number
可选
频率惩罚系数,用于降低模型重复同一内容的可能性
n
integer
可选
返回的生成数量
response_format
object
可选
指定模型必须输出的格式的对象
tools
array
可选
模型可能调用的工具列表。目前,仅支持函数作为工具。使用此选项提供模型可能为其生成JSON输入的函数列表。最多支持128个函数
响应体
id
string
请求的唯一标识符
choices
array
生成的回复选项列表
usage
object
令牌使用统计信息
created
integer
创建时间戳
model
string
使用的模型名称
object
enum<string>
对象类型
请求示例
curl -X POST "https://api.example.com/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/QwQ-32B",
"messages": [
{
"role": "system",
"content": "你是一个有用的AI助手。"
},
{
"role": "user",
"content": "你好,请介绍一下自己。"
}
],
"temperature": 0.7,
"max_tokens": 512
}'
响应示例
{
"id": "chatcmpl-123456789",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是一个AI助手,由先进的语言模型技术驱动。我可以回答问题、提供信息、协助完成各种任务,比如撰写文本、解释概念、提供建议等。我的目标是尽可能地提供有用、准确和有帮助的回应。如果你有任何问题或需要帮助,随时可以告诉我!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 29,
"completion_tokens": 108,
"total_tokens": 137
},
"created": 1677858242,
"model": "Qwen/QwQ-32B",
"object": "chat.completion"
}