常见问题

接入与账号

Base URL 是什么？

Base URL 是 SilvaMux 的接入域名。文档示例中的 https://www.silvamux.com 会在网站构建时替换为当前站点配置的域名。

API Key 在哪创建？

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

`model` 字段填什么？

填写模型详情页展示的调用名，优先使用稳定的 alias。不要根据展示名称自行拼接。

对话与模型

应该选择统一入口还是兼容入口？

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

多模态内容为什么调用失败？

模型必须支持对应输入类型。纯文本模型收到图片或音频内容时可能返回错误。

图片生成

文生图和图片编辑用同一个接口吗？

不是。文生图和图片编辑使用不同接口，请按接口文档选择。

413 REQUEST_TOO_LARGE

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

视频与任务

视频生成使用火山 AK/SK 吗？

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

视频任务怎么查询结果？

创建任务后轮询任务查询接口，直到状态变为成功或失败。具体状态和结果字段以接口契约为准。

429 CONCURRENCY_LIMIT_EXCEEDED

达到并发上限，等待后重试。