快速开始

本指南从当前工作区和项目开始，帮助你创建 API Key、确认模型调用名，并发出第一个 OpenAI Chat Completions 兼容请求。

1. 获取 API Key

1. 注册并登录控制台，进入当前工作区。
2. 在“项目”页面确认至少有一个项目；没有项目时先创建。
3. 进入“密钥”页面，点击“生成 API Key”。
4. 填写名称，选择绑定项目和 API 版本，然后创建。
5. 立即保存以 sk_live_ 开头的完整 Key。完整值仅在创建时显示一次。

建议将 Key 存为环境变量：

export SILVAMUX_API_KEY="sk_live_YOUR_API_KEY"

2. 发送第一个请求

SilvaMux 支持 OpenAI Chat Completions 兼容格式。如果你已有 OpenAI SDK 代码，只需修改 Base URL 和 API Key。

关于 model 字段：填写模型广场详情页展示的调用名，优先使用稳定的 alias。不要根据展示名称自行拼接。

curl

curl https://silvamux.io/api/v1/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)

安装依赖：pip install openai

import os
from openai import OpenAI

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

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

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

Node.js (OpenAI SDK)

安装依赖：npm install openai

import OpenAI from "openai";

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

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://silvamux.io/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
  }'

流式响应格式为 Server-Sent Events，每个事件的 data 字段包含一个 JSON chunk。最终可能收到 choices 为空、带有 usage 的用量 chunk，随后服务器关闭连接。客户端应以流结束为准，不要仅依赖 data: [DONE] 判断完成。

4. 使用 Anthropic 格式

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

curl https://silvamux.io/api/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": "你好"}]
  }'