接入 & 计费

千木（SilvaMux）API 兼容 OpenAI 和 Anthropic 协议，通过 API Key 即可接入。支持订阅套餐和按量付费两种计费方式。

快速接入

只需将 Base URL 指向千木（SilvaMux）网关，使用你的 API Key 即可调用。如果你已经在使用 OpenAI SDK，只需修改 base_url 参数，无需更改其他代码。

请求示例

curl https://api.silvamux.com/v1/chat/completions \
  -H "Authorization: Bearer sk-payg-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python SDK 示例

from openai import OpenAI

client = OpenAI(
    base_url="https://api.silvamux.com/v1",
    api_key="sk-payg-your-api-key"  # PAYG Key
    # api_key="sk-sub-your-api-key"  # 订阅 Key
)

response = client.chat.completions.create(
    model="deepseek-v3.2",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

API Key 类型

创建 API Key 时需选择计费模式，不同模式影响请求的计费方式和可用能力。两种 Key 通过前缀区分：

Key 格式差异：
sk-sub-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx — 订阅 Key（前缀 sk-sub-）
sk-payg-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx — 按量付费 Key（前缀 sk-payg-）

对比项	订阅 Key	PAYG Key
Key 格式	`sk-sub-...`	`sk-payg-...`
计费方式	消耗订阅套餐配额	按 Token 用量从余额扣款
适合场景	用量稳定、高频调用	用量波动、评估测试
频率限制	按套餐 RPM/TPM 限制	不限制 RPM/TPM
超额处理	配额耗尽返回 429	余额不足返回 402
高级能力	智能路由、语义缓存（Pro）	基础路由
成本可预测性	固定月费，可预测	按实际用量浮动

订阅套餐

订阅套餐适合月用量稳定且较大的用户。购买后获得固定配额，在配额内按次消耗，用完即止。支持月付、季付、年付，长周期享更高配额和更低月均成本。

套餐	月均价格	月配额	RPM
Free	免费	100	3
Lite	¥99 起	1,000–1,200	60
Pro	¥499 起	10,000–15,000	600

查看完整套餐对比 →

按量付费（PAYG）

按量付费适合用量波动大或刚开始评估的用户。不购买套餐，按实际调用的 Token 数量计费。每个模型按单次请求的 Token 总数分档定价，小请求享更低单价。

梯度计费规则：分档依据为单次请求的 Token 总数（输入 + 输出）。每个模型有独立的输入/输出梯度档位，breakpoints 因模型而异。请求完成后自动按对应档位的百万 Token 单价计费，无需手动选择。

查看模型梯度定价 →

Key 管理接口

方法	路径	说明
`POST`	`/api/v1/keys`	创建 API Key（指定计费模式）
`GET`	`/api/v1/keys`	列出所有 Key
`DELETE`	`/api/v1/keys/:id`	吊销 API Key

错误码	HTTP 状态码	说明
`40100`	401	缺少认证信息
`40101`	401	认证信息无效
`42901`	429	请求频率超限（RPM / TPM）
`40201`	402	余额不足（PAYG）
`40202`	402	配额已耗尽（订阅）