对话补全 API

SilvaMux 提供一个统一入口和多种格式兼容入口。新接入推荐用统一入口；已有官方 SDK 代码或旧接入可继续用格式兼容入口，互不影响。

统一入口（推荐）

POST /api/v0/chat/completions 是统一入口，按 model 自动选上游并转换格式，响应/SSE/错误统一吐回 OpenAI Chat 格式。一条入口调任意模型（OpenAI / Anthropic / 火山 / 智谱 / Responses 等均支持），无需按模型选端点。

curl https://www.silvamux.com/api/v0/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI SDK 配 base_url="<接入域名>/api/v0" 即可直接用（SDK 自动拼 /chat/completions），<接入域名> 即文档示例中 https://www.silvamux.com 替换后的实际域名。

统一入口支持 tool calling、reasoning、多模态，按模型能力自动处理。响应恒为 OpenAI Chat 格式，即使上游是 Anthropic / Volcengine / Responses 模型。

格式兼容入口（旧模式 / 官方迁移）

下列端点各自收原生格式，请求体原样透传给模型侧，适合已有官方 SDK 代码或需要字段级透传的场景。所有端点均保留，向前兼容。

统一入口与格式兼容入口区别：统一入口经过格式转换层（OpenAI Chat ↔ 上游格式），能跨格式调用但会规范化请求/响应结构；格式兼容入口原样透传，字段保真但只能调对应格式的模型。

认证： Authorization: Bearer <API_KEY> 或 x-api-key: <API_KEY>。

关键参数

完整参数与 OpenAI / Anthropic 官方 API 一致，透传给模型侧。model 调用名调 GET /billing/models 获取（hidden 不显示）。

OpenAI 格式示例

curl https://www.silvamux.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "你好"}
    ],
    "stream": false
  }'

响应（OpenAI 格式）：

{
  "id": "chatcmpl-xxxx",
  "choices": [
    {
      "message": {"role": "assistant", "content": "你好！有什么可以帮你的吗？"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 20, "completion_tokens": 15, "total_tokens": 35}
}

Anthropic 格式示例

curl https://www.silvamux.com/api/anthropic/v1/messages \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

响应（Anthropic 格式）：

{
  "id": "msg_xxxx",
  "type": "message",
  "role": "assistant",
  "content": [{"type": "text", "text": "你好！有什么可以帮你的吗？"}],
  "usage": {"input_tokens": 10, "output_tokens": 15}
}

Volcengine v3 格式示例

兼容火山方舟 OpenAI 兼容接口，可用于豆包 Seed 系列等走火山 v3 协议的模型。

curl https://www.silvamux.com/api/v3/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2.0-pro",
    "messages": [{"role": "user", "content": "你好"}]
  }'

https://www.silvamux.com/api/v3 即接入域名下的 /api/v3，对应路由 /api/v3/chat/completions。

Responses 格式示例

兼容 OpenAI Responses API，适用于支持的模型（如 codex 系列）。

curl https://www.silvamux.com/api/v1/responses \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex-maple",
    "input": "用一句话介绍你自己"
  }'

流式输出

设置 stream: true 即可获得流式响应（SSE）：

curl https://www.silvamux.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [{"role": "user", "content": "写一首五言绝句"}],
    "stream": true
  }'

响应为 text/event-stream，每个事件以 data: 开头，最后一个为 data: [DONE]，最终 chunk 含 usage 用量。Anthropic 格式流式遵循 Anthropic SSE 规范。

Python SDK 流式：

stream = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[{"role": "user", "content": "写一首五言绝句"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

多模态输入

messages 中可传入图片（image_url，OpenAI vision 格式）和音频（input_audio），平台透传给模型侧，能否处理取决于模型。

可用模型

样例模型：minimax-m2.5、kimi-k2.5、glm-5.1、deepseek-v4-pro、doubao-seed-2.0-pro 等。

完整模型清单见模型广场。

计费

对话按 token 用量计费（输入 + 输出），流式与非流式计费一致，具体单价调 GET /billing/models 接口。