⌕
返回控制台

ChatCompletions格式

POST/v1/chat/completions

ChatCompletions格式

根据对话历史创建模型响应。支持流式和非流式响应。

兼容 OpenAI Chat Completions API。

请求体 application/json

modelstring必填
模型 ID
示例: gpt-4
messagesarray<object>必填
对话消息列表
rolestring必填
消息角色
可选值: system, user, assistant, tool, developer
contentoneOf必填
消息内容
oneOf #1
oneOf #2
typestring
可选值: text, image_url, input_audio, file, video_url
textstring
image_urlobject
urlstring
图片 URL 或 base64
detailstring
可选值: low, high, auto
input_audioobject
datastring
Base64 编码的音频数据
formatstring
可选值: wav, mp3
fileobject
filenamestring
file_datastring
file_idstring
video_urlobject
urlstring
namestring
发送者名称
tool_callsarray<object>
idstring
typestring
示例: function
functionobject
namestring
argumentsstring
tool_call_idstring
工具调用 ID（用于 tool 角色消息）
reasoning_contentstring
推理内容
temperaturenumber
采样温度
默认: 1
top_pnumber
核采样参数
默认: 1
ninteger
生成数量
默认: 1
streamboolean
是否流式响应
默认: False
stream_optionsobject
include_usageboolean
stoponeOf
停止序列
oneOf #1
oneOf #2
max_tokensinteger
最大生成 Token 数
max_completion_tokensinteger
最大补全 Token 数
presence_penaltynumber
默认: 0
frequency_penaltynumber
默认: 0
logit_biasobject
userstring
toolsarray<object>
typestring
示例: function
functionobject
namestring
descriptionstring
parametersobject
JSON Schema 格式的参数定义
tool_choiceoneOf
oneOf #1
oneOf #2
typestring
functionobject
namestring
response_formatobject
typestring
可选值: text, json_object, json_schema
json_schemaobject
JSON Schema 定义
seedinteger
reasoning_effortstring
推理强度 (用于支持推理的模型)
可选值: low, medium, high
modalitiesarray<string>
audioobject
voicestring
formatstring

响应

200 成功创建响应
idstring
objectstring
示例: chat.completion
createdinteger
modelstring
choicesarray<object>
indexinteger
messageobject
rolestring必填
消息角色
可选值: system, user, assistant, tool, developer
contentoneOf必填
消息内容
oneOf #1
oneOf #2
typestring
可选值: text, image_url, input_audio, file, video_url
textstring
image_urlobject
urlstring
图片 URL 或 base64
detailstring
可选值: low, high, auto
input_audioobject
datastring
Base64 编码的音频数据
formatstring
可选值: wav, mp3
fileobject
filenamestring
file_datastring
file_idstring
video_urlobject
urlstring
namestring
发送者名称
tool_callsarray<object>
idstring
typestring
示例: function
functionobject
namestring
argumentsstring
tool_call_idstring
工具调用 ID（用于 tool 角色消息）
reasoning_contentstring
推理内容
finish_reasonstring
可选值: stop, length, tool_calls, content_filter
usageobject
prompt_tokensinteger
提示词 Token 数
completion_tokensinteger
补全 Token 数
total_tokensinteger
总 Token 数
prompt_tokens_detailsobject
cached_tokensinteger
text_tokensinteger
audio_tokensinteger
image_tokensinteger
completion_tokens_detailsobject
text_tokensinteger
audio_tokensinteger
reasoning_tokensinteger
system_fingerprintstring
400 请求参数错误
errorobject
messagestring
错误信息
typestring
错误类型
paramstring可空
相关参数
codestring可空
错误代码
429 请求频率限制
errorobject
messagestring
错误信息
typestring
错误类型
paramstring可空
相关参数
codestring可空
错误代码
ThinkMaaS 文档 · 内容基于 New API 开源项目文档（QuantumNous/new-api-docs）本地化镜像