Skip to content

聊天补全 ​

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

请求参数 ​

参数类型必填说明
modelstring是模型 ID。
messagesobject 数组是对话消息列表。
temperaturenumber否采样温度,默认 1,范围 0 到 2。
top_pnumber否核采样参数,默认 1,范围 0 到 1。
ninteger否生成数量,默认 1。
streamboolean否是否流式响应,默认 false。
stream_optionsobject否流式响应选项。
stopstring 或 string 数组否停止序列。
max_tokensinteger否最大生成 Token 数。
max_completion_tokensinteger否最大补全 Token 数。
presence_penaltynumber否存在惩罚,默认 0,范围 -2 到 2。
frequency_penaltynumber否频率惩罚,默认 0,范围 -2 到 2。
toolsobject 数组否工具调用定义。
tool_choicestring 或 object否工具选择策略。
response_formatobject否响应格式约束。
seedinteger否随机种子。
reasoning_effortstring否推理强度,可取 low、medium、high。
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。" }
    ]
  }'

响应 ​

典型响应包含 id、object、created、model、choices[]、usage 和 system_fingerprint。choices[].message 中可能包含 content、tool_calls、reasoning_content 等字段。