常见问题

接入与账号

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

对话（OpenAI Chat Completions 兼容格式，推荐）：https://www.silvamux.com/api/v1/chat/completions
对话统一入口（可选，跨协议转换）：https://www.silvamux.com/api/v0/chat/completions
对话（Anthropic 格式）：https://www.silvamux.com/api/v1/messages
图片、视频和 3D：https://www.silvamux.com/api/v3/...

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

填写模型调用名（模型 id 或 alias），优先使用 alias，例如 minimax-m2.5。当前可用模型以模型目录接口和模型广场为准。

历史 供应商/模型 格式仍兼容，建议新接入使用更简洁、稳定的 alias。

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

在控制台充值。余额不足时模型请求返回 INSUFFICIENT_BALANCE（HTTP 402）。

不是。未配置折扣时按原价计费，折扣系数为 1。折扣由管理员按组织和计价分组配置。

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

请求触发限流，等待后重试，建议使用指数退避。图片和视频生成达到并发上限时会返回 CONCURRENCY_LIMIT_EXCEEDED。

模型侧暂时异常，可以重试；持续失败时联系平台并提供 X-Request-Id。

不会。已结算的 token 不会重复扣费；中断后重新请求按新请求的实际用量计费。

SilvaMux 会将图片和音频等内容透传给模型侧。模型是否支持对应输入类型，以模型能力为准；纯文本模型接收图片或音频时可能返回错误。

使用 OpenAI、Anthropic、Gemini、Volcengine 或智谱 SDK 时，优先选择对应的兼容入口。需要通过一个入口跨协议调用不同模型时，可以使用 SilvaMux 统一入口。

不是。文生图使用 POST /api/v3/images/generations，图片编辑使用 POST /api/v3/images/edits（multipart/form-data）。

请求体超过 64 MB 上限。压缩图片或减少输入图片数量后重试。

不使用。视频生成使用 SilvaMux API Key。火山 V4 签名只用于火山兼容的素材管理接口。

轮询 GET /api/v3/contents/generations/tasks/:id，直到 status 变为 succeed（读取 result.video_url）或 failed。

组织缺少该模型要求的权限标志，需要联系管理员开通。

任务长时间未查询或超时未完成会过期，需要重新创建任务。