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