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

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

查看原文

OpenAI 兼容 API

完全兼容 OpenAI SDK，只需替换 Base URL 和 API Key 即可无缝迁移。支持 Chat Completions、Completions 两种接口。下方端点点击可展开查看参数、7 语言代码示例与响应，并支持在线测试。

BASE URLhttps://router.shengsuanyun.com/api
认证方式Authorization: Bearer YOUR_API_KEY

端点列表

下一页 →
Anthropic 兼容 API

接口参考

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

蓝天 API 密钥
POST/chat/completionsopenai兼容接口聊天

本接口支持聊天补全、与AI模型进行多轮对话。胜算云为模型路由提供了自动路由、提供商路由两种选择。 工具调用允许模型根据上下文选择一个或多个外部函数。模型不会直接执行函数，而是返回工具调用意图和 JSON 参数；业务代码执行函数后，再把结果作为 `role: tool` 消息发回模型。真实请求地址仍是 `POST /v1/chat/completions`； 胜算云还提供联网搜索功能。您只需在请求体里增加 "online_search": true 即可启用搜索功能。

请求体 · 必填

application/json
字段类型说明
model必填string模型 ID，格式为 provider/model-name。
messages必填array多轮对话消息列表。
展开结构

多轮对话消息列表。

array

数组元素
字段类型说明
role必填string消息角色。

可选值："system" · "user" · "assistant" · "tool"

content必填union消息内容。可为字符串，也可为多模态内容数组。
展开结构

消息内容。可为字符串，也可为多模态内容数组。

union

oneOf · 1

string

oneOf · 2

array

数组元素
字段类型说明
typestring

可选值："text" · "image_url" · "input_audio"

textstring
image_urlobject
展开结构

嵌套结构：object

input_audioobject
展开结构

嵌套结构：object

tool_callsarray
展开结构

array

数组元素
字段类型说明
idstring
typestring

可选值："function"

functionobject
展开结构
字段类型说明
namestring
argumentsstringJSON 字符串参数。
tool_call_idstringrole=tool 时对应的工具调用 ID。
streamboolean是否使用 SSE 流式响应。
stream_optionsobject流式输出选项，仅在 stream=true 时生效。
展开结构

流式输出选项，仅在 stream=true 时生效。

字段类型说明
include_usageboolean是否在最后一个 chunk 返回 usage。
online_searchboolean是否启用联网搜索。默认使用博查 AI 搜索。
online_search_optionsobject联网搜索选项。
展开结构

联网搜索选项。

字段类型说明
globalbooleantrue 时使用 Tavily 国际搜索。
max_tokensinteger限制模型生成的最大 token 数。
max_completion_tokensinteger限制 reasoning 模型生成 completion 的最大 token 数。
temperaturenumber采样温度。值越高输出越随机。
top_pnumber核采样阈值。通常不建议和 temperature 同时调整。
stopunion遇到指定字符串时停止生成。
展开结构

遇到指定字符串时停止生成。

union

oneOf · 1

string

oneOf · 2

array

数组元素

string

ninteger生成多个候选回复。部分模型支持。
frequency_penaltynumber降低重复用词概率。
presence_penaltynumber提高模型讨论新主题的倾向。
response_formatobject
展开结构
字段类型说明
typestring

可选值："text" · "json_object" · "json_schema"

json_schemaobject
展开结构
字段类型说明
namestring
descriptionstring
schemaobject
strictboolean
toolsarray模型可调用的工具列表。
展开结构

模型可调用的工具列表。

array

数组元素
字段类型说明
type必填string

可选值："function"

functionobject
展开结构
字段类型说明
name必填string函数名称。
descriptionstring函数用途说明。
parametersobjectJSON Schema 参数定义。
strictboolean是否严格按照 parameters JSON Schema 生成参数。
tool_choiceunion控制模型是否调用工具。
展开结构

控制模型是否调用工具。

union

oneOf · 1

string · "none" | "auto" | "required"

oneOf · 2

object

parallel_tool_callsboolean是否允许模型在一轮响应中并行返回多个工具调用。
auto_routeboolean是否自动路由模型供应商。
supplierstring当 auto_route=false 时指定供应商。

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

reasoningobject控制支持推理模型的思考模式。
展开结构

控制支持推理模型的思考模式。

字段类型说明
effortstring推理强度。

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

max_tokensinteger最大推理 token 数。
typestring开启或关闭思考模式。

可选值："enabled" · "disabled"

{
  "model": "openai/gpt-5.2",
  "messages": [
    {
      "role": "user",
      "content": "上海今天适合夜跑吗？"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_current_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name, e.g. Shanghai"
            },
            "unit": {
              "type": "string",
              "enum": [
                "celsius",
                "fahrenheit"
              ]
            }
          },
          "required": [
            "location"
          ]
        },
        "strict": true
      }
    }
  ],
  "tool_choice": "auto",
  "parallel_tool_calls": true
}

请求示例

参考地址：https://router.shengsuanyun.com/api/v1。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "openai/gpt-5.2",
  "messages": [
    {
      "role": "user",
      "content": "上海今天适合夜跑吗？"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_current_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name, e.g. Shanghai"
            },
            "unit": {
              "type": "string",
              "enum": [
                "celsius",
                "fahrenheit"
              ]
            }
          },
          "required": [
            "location"
          ]
        },
        "strict": true
      }
    }
  ],
  "tool_choice": "auto",
  "parallel_tool_calls": true
}'

响应

200 模型返回普通消息或工具调用

application/json

未提供结构定义。

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "tool_calls": [
          {
            "id": "call_weather_1",
            "type": "function",
            "function": {
              "name": "get_current_weather",
              "arguments": "{\"location\":\"上海\",\"unit\":\"celsius\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}
POST/completionsCompletions

补全兼容入口。胜算云当前该入口使用 messages 数组提交内容；如需标准 OpenAI legacy prompt 续写，请优先使用 Chat Completions 迁移。

请求体 · 必填

application/json
字段类型说明
model必填string
messages必填array消息数组。当前 /v1/completions 兼容入口按 messages 请求体运行。
展开结构

消息数组。当前 /v1/completions 兼容入口按 messages 请求体运行。

array

数组元素
字段类型说明
role必填string消息角色。

可选值："system" · "user" · "assistant" · "tool"

content必填union消息内容。可为字符串，也可为多模态内容数组。
展开结构

消息内容。可为字符串，也可为多模态内容数组。

union

oneOf · 1

string

oneOf · 2

array

数组元素
字段类型说明
typestring

可选值："text" · "image_url" · "input_audio"

textstring
image_urlobject
展开结构

嵌套结构：object

input_audioobject
展开结构

嵌套结构：object

tool_callsarray
展开结构

array

数组元素
字段类型说明
idstring
typestring

可选值："function"

functionobject
展开结构
字段类型说明
namestring
argumentsstringJSON 字符串参数。
tool_call_idstringrole=tool 时对应的工具调用 ID。
max_tokensinteger
streamboolean
temperaturenumber
{
  "model": "deepseek/deepseek-v4-flash",
  "messages": [
    {
      "role": "user",
      "content": "请只回复 OK。"
    }
  ],
  "max_tokens": 8
}

请求示例

参考地址：https://router.shengsuanyun.com/api/v1。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "deepseek/deepseek-v4-flash",
  "messages": [
    {
      "role": "user",
      "content": "请只回复 OK。"
    }
  ],
  "max_tokens": 8
}'

响应

200 成功响应
400 请求格式错误
401 认证失败
GET/models获取模型列表

获取当前账号可用的所有模型列表。常用于验证 API Key 是否有效。

请求示例

参考地址：https://router.shengsuanyun.com/api/v1。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 模型列表

application/json

未提供结构定义。

{
  "object": "list",
  "data": [
    {
      "id": "deepseek/deepseek-v4-flash",
      "object": "model",
      "owned_by": "deepseek"
    },
    {
      "id": "anthropic/claude-sonnet-4.6",
      "object": "model",
      "owned_by": "anthropic"
    }
  ]
}
401 认证失败
POST/responsesResponses

统一响应接口，适合通用 Agent、Codex / Research 类模型、工具调用、联网搜索和需要跨轮次状态的任务。 与 OpenAI 官方 Responses API 一致：使用 `input` 表达用户输入，使用 `tools` 声明可用工具，返回 `output` 数组和文本输出。 仅支持 `/v1/responses` 的模型也会在实时模型列表中显示。

请求体 · 必填

application/json
字段类型说明
model必填string支持 /v1/responses 的模型 ID。
input必填union用户输入。可以是字符串，也可以是包含角色与内容的输入数组。
展开结构

用户输入。可以是字符串，也可以是包含角色与内容的输入数组。

union

oneOf · 1

string

oneOf · 2

array

数组元素

object

instructionsstring开发者/系统级指令。
previous_response_idstring上一轮 response id，用于延续上下文。
streamboolean是否使用流式响应。
toolsarray可用工具。支持函数工具和官方内置工具，如 web_search_preview。
展开结构

可用工具。支持函数工具和官方内置工具，如 web_search_preview。

array

数组元素

union

oneOf · 1
字段类型说明
type必填string

可选值："function"

name必填string
descriptionstring
parametersobjectJSON Schema 参数定义。
oneOf · 2
字段类型说明
typestring

可选值："web_search_preview" · "file_search" · "computer_use_preview"

tool_choiceunion控制工具选择。
展开结构

控制工具选择。

union

oneOf · 1

string · "auto" | "none" | "required"

oneOf · 2

object

temperaturenumber
top_pnumber
max_output_tokensinteger最大输出 token 数。OpenAI Responses 当前最小值通常为 16。
textobject文本输出配置，包括 JSON schema 输出格式。
展开结构

文本输出配置，包括 JSON schema 输出格式。

字段类型说明
formatobject
{
  "model": "openai/gpt-5.2",
  "input": "请阅读这个仓库的 README，并给出迁移到 Responses API 的改造清单。",
  "max_output_tokens": 64,
  "stream": false
}

请求示例

参考地址：https://router.shengsuanyun.com/api/v1。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/responses' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "openai/gpt-5.2",
  "input": "请阅读这个仓库的 README，并给出迁移到 Responses API 的改造清单。",
  "max_output_tokens": 64,
  "stream": false
}'

响应

200 成功响应

application/json

字段类型说明
idstring
objectstring

可选值："response"

modelstring
outputarray
展开结构

array

数组元素

object

output_textstring
usageobject
展开结构
字段类型说明
input_tokensinteger
output_tokensinteger
total_tokensinteger
{
  "id": "resp_xxx",
  "object": "response",
  "model": "openai/gpt-5.2",
  "output_text": "可以，下面是迁移清单...",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "可以，下面是迁移清单..."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 120,
    "output_tokens": 320,
    "total_tokens": 440
  }
}
400 请求格式错误
401 认证失败
404 模型不存在或不支持 /v1/responses
429 频率限制
POST/embeddingsEmbeddings

文本向量化接口。将字符串或字符串数组转换为 embedding 向量，常用于语义检索、RAG、聚类、推荐和相似度计算。

请求体 · 必填

application/json
字段类型说明
model必填stringEmbedding 模型 ID。已验证可用示例：openai/text-embedding-3-small。

可选值："openai/text-embedding-3-small" · "openai/text-embedding-3-large" · "text-embedding-3-small"

input必填union待向量化文本。
展开结构

待向量化文本。

union

oneOf · 1

string

oneOf · 2

array

数组元素

string

encoding_formatstring返回向量编码格式。
dimensionsinteger向量维度，部分模型支持。
{
  "model": "openai/text-embedding-3-small",
  "input": "如何使用 torchserve 部署模型"
}

请求示例

参考地址：https://router.shengsuanyun.com/api/v1。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/embeddings' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "openai/text-embedding-3-small",
  "input": "如何使用 torchserve 部署模型"
}'

响应

200 成功响应

application/json

字段类型说明
objectstring

可选值："list"

dataarray
展开结构

array

数组元素
字段类型说明
objectstring
indexinteger
embeddingarray
展开结构

array

数组元素

number

modelstring
usageobject
展开结构
字段类型说明
prompt_tokensinteger
total_tokensinteger
{
  "object": "list",
  "model": "openai/text-embedding-3-small",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        -0.0142,
        -0.0095,
        -0.0469
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "total_tokens": 13
  }
}
400 请求参数错误，例如 input 为空
401 认证失败