Skip to content

聊天补全

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

请求参数

参数类型必填说明
modelstring模型 ID。
messagesobject 数组对话消息列表。
temperaturenumber采样温度,默认 1,范围 02
top_pnumber核采样参数,默认 1,范围 01
ninteger生成数量,默认 1
streamboolean是否流式响应,默认 false
stream_optionsobject流式响应选项。
stopstring 或 string 数组停止序列。
max_tokensinteger最大生成 Token 数。
max_completion_tokensinteger最大补全 Token 数。
presence_penaltynumber存在惩罚,默认 0,范围 -22
frequency_penaltynumber频率惩罚,默认 0,范围 -22
toolsobject 数组工具调用定义。
tool_choicestring 或 object工具选择策略。
response_formatobject响应格式约束。
seedinteger随机种子。
reasoning_effortstring推理强度,可取 lowmediumhigh
modalitiesstring 数组多模态输出类型。
audioobject音频输出配置。

示例

bash
curl -X POST "https://one.gloscai.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      { "role": "system", "content": "你是一个简洁的助手。" },
      { "role": "user", "content": "用一句话介绍 New API。" }
    ]
  }'

响应

典型响应包含 idobjectcreatedmodelchoices[]usagesystem_fingerprintchoices[].message 中可能包含 contenttool_callsreasoning_content 等字段。