快速开始

本指南帮助你在 5 分钟内发出第一个 API 请求。

1. 获取 API Key

  1. 注册账号后，在控制台创建组织。
  2. 进入 API Keys 页面创建一个 API Key。Key 格式为 sk_live_ 开头的字符串，仅在创建时显示一次，请妥善保存。
  3. 建议将 Key 存为环境变量：
export SILVAMUX_API_KEY="sk_live_YOUR_API_KEY"

2. 发送第一个请求

SilvaMux 的对话 API 兼容 OpenAI 格式。如果你已有 OpenAI SDK 代码，只需修改 Base URL 和 API Key 即可。

关于 model 字段：填调用名（即模型 id 或 alias），优先用 alias（更稳定，不带日期版本号）。例如 minimax-m2.5、kimi-k2.5、doubao-seedance-1.5-pro。完整清单调 GET /billing/models 接口。

curl

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": "用一句话介绍你自己"}
    ]
  }'

Python (OpenAI SDK)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SILVAMUX_API_KEY"],
    base_url="https://www.silvamux.com/api/v0",
)

response = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SILVAMUX_API_KEY,
  baseURL: "https://www.silvamux.com/api/v0",
});

const response = await client.chat.completions.create({
  model: "minimax-m2.5",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});

console.log(response.choices[0].message.content);

3. 流式输出

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

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": "写一首五言绝句"}],
    "stream": true
  }'

流式响应格式为 Server-Sent Events，每个事件的 data 字段包含一个 JSON chunk，最后一个事件为 data: [DONE]。流式的完整用法见 对话补全 API。

4. 使用 Anthropic 格式

如果你更熟悉 Anthropic 的 Messages API，SilvaMux 同样支持：

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": "你好"}]
  }'

下一步