常见问题

Base URL 是什么？在哪查？

Base URL 是接入域名，构建时按部署自动填入文档示例。例如中文站 API Base URL 形如 https://www.silvamux.com。文档中的 https://www.silvamux.com 占位符在站点构建时自动替换为实际域名，复制示例时无需手动改。

• 对话统一入口（推荐）：https://www.silvamux.com/api/v0/chat/completions
• 对话（OpenAI 格式）：https://www.silvamux.com/api/v1/chat/completions
• 对话（Anthropic 格式）：https://www.silvamux.com/api/anthropic/v1/messages
• 图片/视频/3D：https://www.silvamux.com/api/v3/...

API Key 在哪创建？格式是什么？

控制台 API Keys 页面创建，格式 sk_live_ 开头，仅创建时显示一次。建议存为环境变量 SILVAMUX_API_KEY。

`model` 字段填什么？

填调用名（模型 id 或 alias），优先用 alias。如 minimax-m2.5、doubao-seedance-1-5-pro-251215。完整清单调 GET /billing/models 接口（hidden 不显示）。

`供应商/模型` 格式还能用吗？

能。历史 供应商/模型 格式仍兼容，但建议用 alias（更简洁）。

什么是 Standard / Pro 档位？要加 `@tune` 吗？

平台支持按档位区分同模型的不同供给侧（@tune 后缀表示标准档），但当前所有模型均为单档，直接用 alias 调用，无需加 @tune。后续上线双档模型时会在模型清单标注。

余额不足怎么办？

充值：控制台「充值」页，或 POST /billing/orders 创建充值订单。余额不足时模型请求返回 INSUFFICIENT_BALANCE（402）。详见 计费说明。

没配置折扣是免费吗？

不是。未配置折扣时按原价计费（系数为 1）。折扣由管理员按组织 × pricing_group 配置。

401 Unauthorized

检查 API Key 是否正确、是否过期。Gateway 接口用 Authorization: Bearer sk_live_... 或 x-api-key: sk_live_...。

429 RATE_LIMITED

触发限流，等待后重试（建议指数退避）。视频/图片生成并发上限会返回 CONCURRENCY_LIMIT_EXCEEDED。

502 UPSTREAM_*

模型侧异常，可重试。持续失败联系平台。

还没找到答案？

• 错误处理：完整错误码
• 联系销售：见页面底部