ChatCompletions格式

根据对话历史创建模型响应。支持流式和非流式响应。 兼容 OpenAI Chat Completions API。

接口信息

  • 请求方式POST
  • 请求地址/v1/chat/completions

认证方式

Bearer Token

请求头:Authorization: Bearer sk-xxxxxx

请求头

参数位置说明
AuthorizationHeaderBearer ,格式:Authorization: Bearer sk-xxxxxx

请求体

Content-Type:application/json

参数名类型是否必填默认值范围/可选值说明
modelstring--模型 ID
messagesarray<object>--对话消息列表
temperaturenumber10 <= value <= 2采样温度
top_pnumber10 <= value <= 1核采样参数
ninteger11 <= value生成数量
streambooleanfalse-是否流式响应
stream_optionsobject--流式额外配置
stopstring | array<string>--停止序列
max_tokensinteger--最大生成 Token 数
max_completion_tokensinteger--最大补全 Token 数
presence_penaltynumber0-2 <= value <= 2存在惩罚
frequency_penaltynumber0-2 <= value <= 2频率惩罚
logit_biasobject--Token 偏差配置
userstring--用户标识
toolsarray<object>--工具定义数组
tool_choicestring | object--工具选择配置
response_formatobject--返回格式约束
seedinteger--随机种子
reasoning_effortstring-"low""medium""high"推理强度 (用于支持推理的模型)
modalitiesarray<string>--媒体输出类型
audioobject--音频参数配置

响应信息

HTTP状态码Content-Type说明
200application/json请求成功
400application/json请求参数错误
429application/json请求限流

请求示例

curl "你的接口地址/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "temperature": 0.7,
    "stream": false
  }'