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