[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-getting-started\u002Ffaq":167},[4,52,69,92,142,159,163],{"title":5,"path":6,"stem":7,"children":8,"page":-1},"快速开始","\u002Fgetting-started","1.getting-started",[9,12,30,44,48],{"title":10,"path":6,"stem":11},"关于 SilvaMux","1.getting-started\u002Findex",{"title":13,"path":14,"stem":15,"children":16,"page":-1},"首次调用千木 API","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start\u002Findex",[17,18,22,26],{"title":13,"path":14,"stem":15},{"title":19,"path":20,"stem":21},"项目和账户设置","\u002Fgetting-started\u002Fquick-start\u002Fproject-and-account","1.getting-started\u002F1.quick-start\u002F2.project-and-account",{"title":23,"path":24,"stem":25},"获取 API Key","\u002Fgetting-started\u002Fquick-start\u002Fapi-key","1.getting-started\u002F1.quick-start\u002F3.api-key",{"title":27,"path":28,"stem":29},"第一个请求","\u002Fgetting-started\u002Fquick-start\u002Ffirst-request","1.getting-started\u002F1.quick-start\u002F4.first-request",{"title":31,"path":32,"stem":33,"children":34,"page":43},"模型与体验","\u002Fgetting-started\u002Fmodels-and-experience","1.getting-started\u002F2.models-and-experience",[35,39],{"title":36,"path":37,"stem":38},"模型选择","\u002Fgetting-started\u002Fmodels-and-experience\u002Fmodel-selection","1.getting-started\u002F2.models-and-experience\u002F1.model-selection",{"title":40,"path":41,"stem":42},"在线体验","\u002Fgetting-started\u002Fmodels-and-experience\u002Fplayground","1.getting-started\u002F2.models-and-experience\u002F2.playground",false,{"title":45,"path":46,"stem":47},"限流","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":49,"path":50,"stem":51},"常见问题","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",{"title":53,"path":54,"stem":55,"children":56,"page":43},"产品计费","\u002Fbilling","2.billing",[57,61,65],{"title":58,"path":59,"stem":60},"计费说明","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":62,"path":63,"stem":64},"在线充值","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":66,"path":67,"stem":68},"账单、用量与导出","\u002Fbilling\u002Fusage-export","2.billing\u002F3.usage-export",{"title":70,"path":71,"stem":72,"children":73,"page":43},"Coding Plan","\u002Fcoding-plan","3.coding-plan",[74,78],{"title":75,"path":76,"stem":77},"Coding Plan 概述","\u002Fcoding-plan\u002Foverview","3.coding-plan\u002F1.overview",{"title":79,"path":80,"stem":81,"children":82,"page":-1},"个人版","\u002Fcoding-plan\u002Fpersonal","3.coding-plan\u002F2.personal\u002Findex",[83,85,89],{"title":84,"path":80,"stem":81},"价格和权益",{"title":86,"path":87,"stem":88},"快速接入","\u002Fcoding-plan\u002Fpersonal\u002Fquick-start","3.coding-plan\u002F2.personal\u002F2.quick-start",{"title":49,"path":90,"stem":91},"\u002Fcoding-plan\u002Fpersonal\u002Ffaq","3.coding-plan\u002F2.personal\u002F3.faq",{"title":93,"path":94,"stem":95,"children":96,"page":43},"模型接口","\u002Fmodels","4.models",[97,130],{"title":98,"path":99,"stem":100,"children":101,"page":43},"文本生成","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[102,106,110,114,118,122,126],{"title":103,"path":104,"stem":105},"概述","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":107,"path":108,"stem":109},"OpenAI 兼容接口","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":111,"path":112,"stem":113},"Anthropic 兼容","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":115,"path":116,"stem":117},"Volcengine 兼容","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":119,"path":120,"stem":121},"智谱兼容","\u002Fmodels\u002Fchat\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":123,"path":124,"stem":125},"SilvaMux 统一入口","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":127,"path":128,"stem":129},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":131,"path":132,"stem":133,"children":134,"page":43},"图片生成","\u002Fmodels\u002Fimages","4.models\u002F2.images",[135,138],{"title":103,"path":136,"stem":137},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":139,"path":140,"stem":141},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":143,"path":144,"stem":145,"children":146,"page":43},"用量与余额","\u002Fusage-and-balance","5.usage-and-balance",[147,151,155],{"title":148,"path":149,"stem":150},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":152,"path":153,"stem":154},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":156,"path":157,"stem":158},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":160,"path":161,"stem":162},"错误码参考","\u002Ferrors","6.errors",{"title":164,"path":165,"stem":166},"文档首页","\u002F","index",{"id":168,"title":49,"body":169,"description":489,"extension":490,"meta":491,"navigation":492,"path":50,"rawbody":493,"requiredFlags":494,"seo":495,"stem":51,"__hash__":496},"docs\u002F1.getting-started\u002F4.faq.md",{"type":170,"value":171,"toc":453},"minimark",[172,175,179,184,196,224,228,244,251,266,273,279,287,296,300,307,311,314,318,327,331,337,341,347,350,354,357,361,364,368,371,373,377,392,396,399,402,406,409,413,435,439,442,450],[173,174,49],"h1",{"id":49},[176,177,178],"h2",{"id":178},"接入与账号",[180,181,183],"h3",{"id":182},"base-url-是什么在哪查","Base URL 是什么？在哪查？",[185,186,187,188,192,193,195],"p",{},"Base URL 是接入域名，构建时按部署自动填入文档示例。例如中文站 API Base URL 形如 ",[189,190,191],"code",{},"https:\u002F\u002Fwww.silvamux.com","。文档中的 ",[189,194,191],{}," 占位符在站点构建时自动替换为实际域名，复制示例时无需手动改。",[197,198,199,206,212,218],"ul",{},[200,201,202,203],"li",{},"对话（OpenAI Chat Completions 兼容格式，推荐）：",[189,204,205],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions",[200,207,208,209],{},"对话统一入口（可选，跨协议转换）：",[189,210,211],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions",[200,213,214,215],{},"对话（Anthropic 格式）：",[189,216,217],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1\u002Fmessages",[200,219,220,221],{},"图片、视频和 3D：",[189,222,223],{},"https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002F...",[180,225,227],{"id":226},"api-key-在哪创建格式是什么","API Key 在哪创建？格式是什么？",[185,229,230,231,235,236,239,240,243],{},"在控制台 ",[232,233,234],"strong",{},"API Keys"," 页面创建。API Key 以 ",[189,237,238],{},"sk_live_"," 开头，仅在创建时显示一次，建议存为环境变量 ",[189,241,242],{},"SILVAMUX_API_KEY","。",[180,245,247,250],{"id":246},"model-字段填什么",[189,248,249],{},"model"," 字段填什么？",[185,252,253,254,257,258,261,262,265],{},"填写模型调用名（模型 ",[189,255,256],{},"id"," 或 ",[189,259,260],{},"alias","），优先使用 alias，例如 ",[189,263,264],{},"minimax-m2.5","。当前可用模型以模型目录接口和模型广场为准。",[180,267,269,272],{"id":268},"供应商模型-格式还能用吗",[189,270,271],{},"供应商\u002F模型"," 格式还能用吗？",[185,274,275,276,278],{},"历史 ",[189,277,271],{}," 格式仍兼容，建议新接入使用更简洁、稳定的 alias。",[180,280,282,283,286],{"id":281},"什么是-standard-pro-档位要加-tune-吗","什么是 Standard \u002F Pro 档位？要加 ",[189,284,285],{},"@tune"," 吗？",[185,288,289,290,292,293,295],{},"平台可以按档位区分同模型的不同供给侧，",[189,291,285],{}," 后缀表示标准档。当前所有模型均为单档，直接使用 alias，无需添加 ",[189,294,285],{},"。后续上线双档模型时会在模型清单标注。",[180,297,299],{"id":298},"余额不足怎么办","余额不足怎么办？",[185,301,302,303,306],{},"在控制台充值。余额不足时模型请求返回 ",[189,304,305],{},"INSUFFICIENT_BALANCE","（HTTP 402）。",[180,308,310],{"id":309},"没配置折扣是免费吗","没配置折扣是免费吗？",[185,312,313],{},"不是。未配置折扣时按原价计费，折扣系数为 1。折扣由管理员按组织和计价分组配置。",[180,315,317],{"id":316},"_401-unauthorized","401 Unauthorized",[185,319,320,321,257,324,243],{},"检查 API Key 是否正确、是否过期。Gateway 接口使用 ",[189,322,323],{},"Authorization: Bearer sk_live_...",[189,325,326],{},"x-api-key: sk_live_...",[180,328,330],{"id":329},"_429-rate_limited","429 RATE_LIMITED",[185,332,333,334,243],{},"请求触发限流，等待后重试，建议使用指数退避。图片和视频生成达到并发上限时会返回 ",[189,335,336],{},"CONCURRENCY_LIMIT_EXCEEDED",[180,338,340],{"id":339},"_502-upstream_","502 UPSTREAM_*",[185,342,343,344,243],{},"模型侧暂时异常，可以重试；持续失败时联系平台并提供 ",[189,345,346],{},"X-Request-Id",[176,348,349],{"id":349},"对话与模型",[180,351,353],{"id":352},"流式响应中断了会重复计费吗","流式响应中断了会重复计费吗？",[185,355,356],{},"不会。已结算的 token 不会重复扣费；中断后重新请求按新请求的实际用量计费。",[180,358,360],{"id":359},"多模态内容为什么调用失败","多模态内容为什么调用失败？",[185,362,363],{},"SilvaMux 会将图片和音频等内容透传给模型侧。模型是否支持对应输入类型，以模型能力为准；纯文本模型接收图片或音频时可能返回错误。",[180,365,367],{"id":366},"应该选择统一入口还是兼容入口","应该选择统一入口还是兼容入口？",[185,369,370],{},"使用 OpenAI、Anthropic、Gemini、Volcengine 或智谱 SDK 时，优先选择对应的兼容入口。需要通过一个入口跨协议调用不同模型时，可以使用 SilvaMux 统一入口。",[176,372,131],{"id":131},[180,374,376],{"id":375},"文生图和图片编辑用同一个接口吗","文生图和图片编辑用同一个接口吗？",[185,378,379,380,383,384,387,388,391],{},"不是。文生图使用 ",[189,381,382],{},"POST \u002Fapi\u002Fv3\u002Fimages\u002Fgenerations","，图片编辑使用 ",[189,385,386],{},"POST \u002Fapi\u002Fv3\u002Fimages\u002Fedits","（",[189,389,390],{},"multipart\u002Fform-data","）。",[180,393,395],{"id":394},"_413-request_too_large","413 REQUEST_TOO_LARGE",[185,397,398],{},"请求体超过 64 MB 上限。压缩图片或减少输入图片数量后重试。",[176,400,401],{"id":401},"视频与任务",[180,403,405],{"id":404},"视频生成使用火山-aksk-吗","视频生成使用火山 AK\u002FSK 吗？",[185,407,408],{},"不使用。视频生成使用 SilvaMux API Key。火山 V4 签名只用于火山兼容的素材管理接口。",[180,410,412],{"id":411},"视频任务怎么查询结果","视频任务怎么查询结果？",[185,414,415,416,419,420,423,424,427,428,431,432,243],{},"轮询 ",[189,417,418],{},"GET \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F:id","，直到 ",[189,421,422],{},"status"," 变为 ",[189,425,426],{},"succeed","（读取 ",[189,429,430],{},"result.video_url","）或 ",[189,433,434],{},"failed",[180,436,438],{"id":437},"_403-model_access_denied","403 MODEL_ACCESS_DENIED",[185,440,441],{},"组织缺少该模型要求的权限标志，需要联系管理员开通。",[180,443,445,446,449],{"id":444},"任务状态-expired-是什么意思","任务状态 ",[189,447,448],{},"expired"," 是什么意思？",[185,451,452],{},"任务长时间未查询或超时未完成会过期，需要重新创建任务。",{"title":454,"searchDepth":455,"depth":455,"links":456},"",2,[457,473,478,482],{"id":178,"depth":455,"text":178,"children":458},[459,461,462,464,466,468,469,470,471,472],{"id":182,"depth":460,"text":183},3,{"id":226,"depth":460,"text":227},{"id":246,"depth":460,"text":463},"model 字段填什么？",{"id":268,"depth":460,"text":465},"供应商\u002F模型 格式还能用吗？",{"id":281,"depth":460,"text":467},"什么是 Standard \u002F Pro 档位？要加 @tune 吗？",{"id":298,"depth":460,"text":299},{"id":309,"depth":460,"text":310},{"id":316,"depth":460,"text":317},{"id":329,"depth":460,"text":330},{"id":339,"depth":460,"text":340},{"id":349,"depth":455,"text":349,"children":474},[475,476,477],{"id":352,"depth":460,"text":353},{"id":359,"depth":460,"text":360},{"id":366,"depth":460,"text":367},{"id":131,"depth":455,"text":131,"children":479},[480,481],{"id":375,"depth":460,"text":376},{"id":394,"depth":460,"text":395},{"id":401,"depth":455,"text":401,"children":483},[484,485,486,487],{"id":404,"depth":460,"text":405},{"id":411,"depth":460,"text":412},{"id":437,"depth":460,"text":438},{"id":444,"depth":460,"text":488},"任务状态 expired 是什么意思？","集中查看接入、对话、图片和视频任务中的常见问题。","md",{},true,"---\ntitle: 常见问题\ndescription: 集中查看接入、对话、图片和视频任务中的常见问题。\n---\n\n# 常见问题\n\n## 接入与账号\n\n### Base URL 是什么？在哪查？\n\nBase URL 是接入域名，构建时按部署自动填入文档示例。例如中文站 API Base URL 形如 `https:\u002F\u002Fwww.silvamux.com`。文档中的 `https:\u002F\u002Fwww.silvamux.com` 占位符在站点构建时自动替换为实际域名，复制示例时无需手动改。\n\n- 对话（OpenAI Chat Completions 兼容格式，推荐）：`https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions`\n- 对话统一入口（可选，跨协议转换）：`https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions`\n- 对话（Anthropic 格式）：`https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv1\u002Fmessages`\n- 图片、视频和 3D：`https:\u002F\u002Fwww.silvamux.com\u002Fapi\u002Fv3\u002F...`\n\n### API Key 在哪创建？格式是什么？\n\n在控制台 **API Keys** 页面创建。API Key 以 `sk_live_` 开头，仅在创建时显示一次，建议存为环境变量 `SILVAMUX_API_KEY`。\n\n### `model` 字段填什么？\n\n填写模型调用名（模型 `id` 或 `alias`），优先使用 alias，例如 `minimax-m2.5`。当前可用模型以模型目录接口和模型广场为准。\n\n### `供应商\u002F模型` 格式还能用吗？\n\n历史 `供应商\u002F模型` 格式仍兼容，建议新接入使用更简洁、稳定的 alias。\n\n### 什么是 Standard \u002F Pro 档位？要加 `@tune` 吗？\n\n平台可以按档位区分同模型的不同供给侧，`@tune` 后缀表示标准档。当前所有模型均为单档，直接使用 alias，无需添加 `@tune`。后续上线双档模型时会在模型清单标注。\n\n### 余额不足怎么办？\n\n在控制台充值。余额不足时模型请求返回 `INSUFFICIENT_BALANCE`（HTTP 402）。\n\n### 没配置折扣是免费吗？\n\n不是。未配置折扣时按原价计费，折扣系数为 1。折扣由管理员按组织和计价分组配置。\n\n### 401 Unauthorized\n\n检查 API Key 是否正确、是否过期。Gateway 接口使用 `Authorization: Bearer sk_live_...` 或 `x-api-key: sk_live_...`。\n\n### 429 RATE_LIMITED\n\n请求触发限流，等待后重试，建议使用指数退避。图片和视频生成达到并发上限时会返回 `CONCURRENCY_LIMIT_EXCEEDED`。\n\n### 502 UPSTREAM_*\n\n模型侧暂时异常，可以重试；持续失败时联系平台并提供 `X-Request-Id`。\n\n## 对话与模型\n\n### 流式响应中断了会重复计费吗？\n\n不会。已结算的 token 不会重复扣费；中断后重新请求按新请求的实际用量计费。\n\n### 多模态内容为什么调用失败？\n\nSilvaMux 会将图片和音频等内容透传给模型侧。模型是否支持对应输入类型，以模型能力为准；纯文本模型接收图片或音频时可能返回错误。\n\n### 应该选择统一入口还是兼容入口？\n\n使用 OpenAI、Anthropic、Gemini、Volcengine 或智谱 SDK 时，优先选择对应的兼容入口。需要通过一个入口跨协议调用不同模型时，可以使用 SilvaMux 统一入口。\n\n## 图片生成\n\n### 文生图和图片编辑用同一个接口吗？\n\n不是。文生图使用 `POST \u002Fapi\u002Fv3\u002Fimages\u002Fgenerations`，图片编辑使用 `POST \u002Fapi\u002Fv3\u002Fimages\u002Fedits`（`multipart\u002Fform-data`）。\n\n### 413 REQUEST_TOO_LARGE\n\n请求体超过 64 MB 上限。压缩图片或减少输入图片数量后重试。\n\n## 视频与任务\n\n### 视频生成使用火山 AK\u002FSK 吗？\n\n不使用。视频生成使用 SilvaMux API Key。火山 V4 签名只用于火山兼容的素材管理接口。\n\n### 视频任务怎么查询结果？\n\n轮询 `GET \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F:id`，直到 `status` 变为 `succeed`（读取 `result.video_url`）或 `failed`。\n\n### 403 MODEL_ACCESS_DENIED\n\n组织缺少该模型要求的权限标志，需要联系管理员开通。\n\n### 任务状态 `expired` 是什么意思？\n\n任务长时间未查询或超时未完成会过期，需要重新创建任务。\n",[],{"title":49,"description":489},"Q3SfLxA4tpffV77H49cDi0k-70tjPg3OSfjmmZuA6Us"]