统一模型接入与用量管理 立即注册
蓝天
文档控制台
原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看 快速开始。

查看原文

POST 聊天补全

POST /v1/chat/completions 聊天补全
所属分组：聊天补全

BASE URLYOUR_PROJECT_BASE_URL（从项目 API Key 页复制，保留项目路径与版本路径）
认证方式Authorization: Bearer 项目 API Key

端点列表

← 上一页
POST 注册企业级网关
下一页 →
POST 文本向量化

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥
POST/v1/chat/completions聊天补全

与AI模型进行多轮对话

请求参数

参数位置 / 类型说明
HTTP-Refererheader / string用于在胜算云Router中排名的应用网站URL
X-Titleheader / string用于在胜算云Router中排名的应用名称

请求体

application/json
字段类型说明
model必填string请求使用的模型 ID。
messagesarray对话的消息列表。
展开结构

对话的消息列表。

array

数组元素

OpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-Message

streamboolean是否使用流式响应。
online_searchboolean是否启用联网搜索功能。
stream_optionsOpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-%20StreamOptions流式输出相关选项，只有在 stream 参数为 true 时，此参数才有效。
max_tokensinteger限制一次请求中模型生成 completion 的最大 token 数。
temperaturenumber采样温度，用于控制模型生成文本的多样性。 更高的值，如 0.8，会使输出更随机，而更低的值，如 0.2，会使其更加集中和确定。
top_pnumber核采样概率阈值，用于控制模型生成文本的多样性。 top_p 越高，生成的文本更多样。反之，生成的文本更确定。 由于 temperature 与 top_p 均可以控制生成文本的多样性，因此建议您只设置其中一个值。
stopunion模型遇到 stop 字段所指定的字符串时将停止继续生成，这个词语本身不会输出。
展开结构

模型遇到 stop 字段所指定的字符串时将停止继续生成，这个词语本身不会输出。

union

oneOf · 1

string

oneOf · 2

array

数组元素

string

ninteger生成响应的个数。对于需要生成多个响应的场景（如创意写作、广告文案等），可以设置较大的 n 值。 当前仅支持 qwen-plus 、doubao-pro 模型，且在传入 tools 参数时固定为1。 设置较大的 n 值不会增加输入 Token 消耗，会增加输出 Token 的消耗。
frequency_penaltynumber频率惩罚系数。如果值为正，会根据新 token 在文本中的出现频率对其进行惩罚，从而降低模型逐字重复的可能性。
presence_penaltynumber存在惩罚系数。如果值为正，会根据新 token 到目前为止是否出现在文本中对其进行惩罚，从而增加模型谈论新主题的可能性。
response_formatOpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ResponseFormatResponse format specification
toolsarray模型可以调用的工具列表。
展开结构

模型可以调用的工具列表。

array

数组元素

OpenAI-Chat%20%E8%AF%B7%E6%B1%82%E4%BD%93-ToolCall

auto_routeboolean是否自动路由模型供应商。
supplierstring指定模型供应商。只有在 `auto_route=false` 时该参数才会生效。

可选值："DeepSeek" · "Bytedance" · "OpenRouter" · "Ali"

reasoningobject设置思维链模式
展开结构

设置思维链模式

字段类型说明
effortstring支持允许控制思维链长度模型

可选值："low" · "medium" · "high"

max_tokensinteger最大推理Token数，控制非OpenAI思考模型思维链长度
typestring开启和关闭思考模式，可选参数： **enabled**、**disabled** 支持大多数混合推理模型
{
  "model": "deepseek/deepseek-v3",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "stream_options": {
    "include_usage": true
  }
}

请求示例

参考地址：YOUR_PROJECT_BASE_URL。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'YOUR_PROJECT_BASE_URL/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "deepseek/deepseek-v3",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "stream_options": {
    "include_usage": true
  }
}'

响应

200 请求成功

application/json

OpenAI%20Chat%20%E5%93%8D%E5%BA%94%E4%BD%93

{
  "id": "20250410143202432620157mDT6DvdC",
  "provider": "OpenRouter",
  "model": "anthropic/claude-3.7-sonnet",
  "object": "chat.completion",
  "created": 1744266722,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I don't have the ability to check real-time weather information for Shanghai or any other location. To get accurate and current weather information for Shanghai, you could:\n\n1. Check a weather website or app such as Weather.com, AccuWeather, or a local Chinese weather service\n2. Search for \"上海天气\" (Shanghai weather) on a search engine\n3. Look at the weather function on your smartphone\n4. Check local Shanghai news websites\n\nIf you need current weather information, these sources will provide you with accurate forecasts, temperature, precipitation chances, and other relevant weather data for Shanghai today."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 133,
    "total_tokens": 149
  }
}
400 参数错误

application/json

string

"string"