[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-en":3,"docs-en-getting-started\u002Ffaq":180},[4,26,43,105,155,172,176],{"title":5,"path":6,"stem":7,"children":8,"page":25},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17,21],{"title":10,"path":11,"stem":12},"Your First SilvaMux API Call","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F1.quick-start",{"title":14,"path":15,"stem":16},"Model Selection","\u002Fgetting-started\u002Fmodel-selection","1.getting-started\u002F2.model-selection",{"title":18,"path":19,"stem":20},"Rate Limits","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F3.rate-limits",{"title":22,"path":23,"stem":24},"FAQ","\u002Fgetting-started\u002Ffaq","1.getting-started\u002F4.faq",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"Billing","\u002Fbilling","2.billing",[31,35,39],{"title":32,"path":33,"stem":34},"Billing Overview","\u002Fbilling\u002Foverview","2.billing\u002F1.overview",{"title":36,"path":37,"stem":38},"Online Top-up","\u002Fbilling\u002Frecharge","2.billing\u002F2.recharge",{"title":40,"path":41,"stem":42},"Bills, Usage & Exports","\u002Fbilling\u002Fusage-export","2.billing\u002F3.usage-export",{"title":44,"path":45,"stem":46,"children":47,"page":25},"Coding Plan","\u002Fcoding-plan","3.coding-plan",[48,52,56,60,67,102],{"title":49,"path":50,"stem":51},"Coding Plan Overview","\u002Fcoding-plan\u002Foverview","3.coding-plan\u002F1.overview",{"title":53,"path":54,"stem":55},"Quick Start","\u002Fcoding-plan\u002Fquick-start","3.coding-plan\u002F2.quick-start",{"title":57,"path":58,"stem":59},"Usage Notes","\u002Fcoding-plan\u002Fusage-notes","3.coding-plan\u002F3.usage-notes",{"title":61,"path":62,"stem":63,"children":64},"Personal","\u002Fcoding-plan\u002Fpersonal","3.coding-plan\u002F4.personal\u002Findex",[65],{"title":66,"path":62,"stem":63},"Pricing & Benefits",{"title":68,"path":69,"stem":70,"children":71,"page":-1},"Developer Guide","\u002Fcoding-plan\u002Fguide","3.coding-plan\u002F5.guide\u002Findex",[72,74,78,82,86,90,94,98],{"title":73,"path":69,"stem":70},"Endpoints & Protocols",{"title":75,"path":76,"stem":77},"Claude Code","\u002Fcoding-plan\u002Fguide\u002Fclaude-code","3.coding-plan\u002F5.guide\u002F1.claude-code",{"title":79,"path":80,"stem":81},"OpenCode","\u002Fcoding-plan\u002Fguide\u002Fopencode","3.coding-plan\u002F5.guide\u002F2.opencode",{"title":83,"path":84,"stem":85},"Cursor","\u002Fcoding-plan\u002Fguide\u002Fcursor","3.coding-plan\u002F5.guide\u002F3.cursor",{"title":87,"path":88,"stem":89},"Codex","\u002Fcoding-plan\u002Fguide\u002Fcodex","3.coding-plan\u002F5.guide\u002F4.codex",{"title":91,"path":92,"stem":93},"ZCode","\u002Fcoding-plan\u002Fguide\u002Fzcode","3.coding-plan\u002F5.guide\u002F5.zcode",{"title":95,"path":96,"stem":97},"TRAE","\u002Fcoding-plan\u002Fguide\u002Ftrae","3.coding-plan\u002F5.guide\u002F6.trae",{"title":99,"path":100,"stem":101},"CodeBuddy","\u002Fcoding-plan\u002Fguide\u002Fcodebuddy","3.coding-plan\u002F5.guide\u002F7.codebuddy",{"title":22,"path":103,"stem":104},"\u002Fcoding-plan\u002Ffaq","3.coding-plan\u002F6.faq",{"title":106,"path":107,"stem":108,"children":109,"page":25},"Model APIs","\u002Fmodels","4.models",[110,143],{"title":111,"path":112,"stem":113,"children":114,"page":25},"Text Generation Model API","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[115,119,123,127,131,135,139],{"title":116,"path":117,"stem":118},"Overview","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":120,"path":121,"stem":122},"OpenAI Compatible API","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":124,"path":125,"stem":126},"Anthropic Compatible","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":128,"path":129,"stem":130},"Volcengine Compatible","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":132,"path":133,"stem":134},"Zhipu Compatible","\u002Fmodels\u002Fchat\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":136,"path":137,"stem":138},"SilvaMux Unified Entry","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":140,"path":141,"stem":142},"Multimodal Input","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":144,"path":145,"stem":146,"children":147,"page":25},"Image Generation Model API","\u002Fmodels\u002Fimages","4.models\u002F2.images",[148,151],{"title":116,"path":149,"stem":150},"\u002Fmodels\u002Fimages\u002Foverview","4.models\u002F2.images\u002F1.overview",{"title":152,"path":153,"stem":154},"Image Generation API","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":156,"path":157,"stem":158,"children":159,"page":25},"Usage & Balance","\u002Fusage-and-balance","5.usage-and-balance",[160,164,168],{"title":161,"path":162,"stem":163},"Query Balance","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":165,"path":166,"stem":167},"Query Usage","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":169,"path":170,"stem":171},"Query Request Usage","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":173,"path":174,"stem":175},"Error Codes","\u002Ferrors","6.errors",{"title":177,"path":178,"stem":179},"Getting Started with SilvaMux","\u002F","index",{"id":181,"title":22,"body":182,"description":512,"extension":513,"meta":514,"navigation":515,"path":23,"rawbody":516,"requiredFlags":517,"seo":518,"stem":24,"__hash__":519},"docs_en\u002F1.getting-started\u002F4.faq.md",{"type":183,"value":184,"toc":476},"minimark",[185,189,194,199,212,240,244,260,268,283,291,297,305,314,318,325,329,332,336,345,349,356,360,366,370,374,377,381,384,388,391,395,399,414,418,421,425,429,432,436,458,462,465,473],[186,187,22],"h1",{"id":188},"faq",[190,191,193],"h2",{"id":192},"onboarding-account","Onboarding & Account",[195,196,198],"h3",{"id":197},"what-is-the-base-url-and-where-do-i-find-it","What is the Base URL and where do I find it?",[200,201,202,203,207,208,211],"p",{},"The Base URL is the access domain, filled into the docs examples automatically per deployment at build time. For example, the CN site API base URL looks like ",[204,205,206],"code",{},"https:\u002F\u002Fwww.silvamux.com",". The ",[204,209,210],{},"https:\u002F\u002Fsilvamux.io"," placeholder in these docs is replaced with the actual domain when the site is built — no manual edits needed when copying examples.",[213,214,215,222,228,234],"ul",{},[216,217,218,219],"li",{},"Chat (OpenAI Chat Completions compatible, recommended): ",[204,220,221],{},"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions",[216,223,224,225],{},"Chat unified entry (optional, cross-protocol): ",[204,226,227],{},"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions",[216,229,230,231],{},"Chat (Anthropic format): ",[204,232,233],{},"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fmessages",[216,235,236,237],{},"Images, video, and 3D: ",[204,238,239],{},"https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3\u002F...",[195,241,243],{"id":242},"where-do-i-create-an-api-key-what-does-it-look-like","Where do I create an API key? What does it look like?",[200,245,246,247,251,252,255,256,259],{},"Create keys on the console ",[248,249,250],"strong",{},"API Keys"," page. Keys start with ",[204,253,254],{},"sk_live_"," and are shown only once at creation; store yours as the environment variable ",[204,257,258],{},"SILVAMUX_API_KEY",".",[195,261,263,264,267],{"id":262},"what-goes-in-the-model-field","What goes in the ",[204,265,266],{},"model"," field?",[200,269,270,271,274,275,278,279,282],{},"Use the model call name (the model ",[204,272,273],{},"id"," or ",[204,276,277],{},"alias","), preferring the alias, for example ",[204,280,281],{},"minimax-m2.5",". The model catalog API and the Model Plaza are authoritative for currently available models.",[195,284,286,287,290],{"id":285},"is-the-legacy-vendormodel-format-still-supported","Is the legacy ",[204,288,289],{},"vendor\u002Fmodel"," format still supported?",[200,292,293,294,296],{},"The legacy ",[204,295,289],{}," format still works, but new integrations should use the simpler, more stable alias.",[195,298,300,301,304],{"id":299},"what-are-the-standard-pro-tiers-do-i-need-tune","What are the Standard \u002F Pro tiers? Do I need ",[204,302,303],{},"@tune","?",[200,306,307,308,310,311,313],{},"The platform can expose the same model through different supply tiers; the ",[204,309,303],{}," suffix marks the standard tier. All models are currently single-tier — use the alias directly without ",[204,312,303],{},". Dual-tier models will be flagged in the model catalog when introduced.",[195,315,317],{"id":316},"what-if-my-balance-runs-out","What if my balance runs out?",[200,319,320,321,324],{},"Top up in the console. When the balance is insufficient, model requests return ",[204,322,323],{},"INSUFFICIENT_BALANCE"," (HTTP 402).",[195,326,328],{"id":327},"does-no-discount-configured-mean-its-free","Does \"no discount configured\" mean it's free?",[200,330,331],{},"No. Without a configured discount you are billed at list price (discount factor 1). Discounts are configured by administrators per organization and pricing group.",[195,333,335],{"id":334},"_401-unauthorized","401 Unauthorized",[200,337,338,339,274,342,259],{},"Check that the API key is correct and not revoked. Gateway APIs use ",[204,340,341],{},"Authorization: Bearer sk_live_...",[204,343,344],{},"x-api-key: sk_live_...",[195,346,348],{"id":347},"_429-rate_limited","429 RATE_LIMITED",[200,350,351,352,355],{},"The request hit a rate limit — wait and retry with exponential backoff. Image and video generation return ",[204,353,354],{},"CONCURRENCY_LIMIT_EXCEEDED"," when the concurrency cap is reached.",[195,357,359],{"id":358},"_502-upstream_","502 UPSTREAM_*",[200,361,362,363,259],{},"The model side is temporarily failing; retries are reasonable. If failures persist, contact the platform with the ",[204,364,365],{},"X-Request-Id",[190,367,369],{"id":368},"chat-models","Chat & Models",[195,371,373],{"id":372},"if-a-streaming-response-is-interrupted-am-i-billed-twice","If a streaming response is interrupted, am I billed twice?",[200,375,376],{},"No. Settled tokens are never charged twice; a retried request is billed only for its own actual usage.",[195,378,380],{"id":379},"why-do-multimodal-calls-fail","Why do multimodal calls fail?",[200,382,383],{},"SilvaMux passes images, audio, and other content through to the model. Whether the input type is supported depends on the model's capabilities; text-only models may return errors when given images or audio.",[195,385,387],{"id":386},"should-i-use-the-unified-entry-or-a-compatible-entry","Should I use the unified entry or a compatible entry?",[200,389,390],{},"When using OpenAI, Anthropic, Gemini, Volcengine, or Zhipu SDKs, prefer the matching compatible entry. Use the SilvaMux unified entry when you want to call different models across protocols through a single endpoint.",[190,392,394],{"id":393},"image-generation","Image Generation",[195,396,398],{"id":397},"do-text-to-image-and-image-editing-share-one-api","Do text-to-image and image editing share one API?",[200,400,401,402,405,406,409,410,413],{},"No. Text-to-image uses ",[204,403,404],{},"POST \u002Fapi\u002Fv3\u002Fimages\u002Fgenerations","; image editing uses ",[204,407,408],{},"POST \u002Fapi\u002Fv3\u002Fimages\u002Fedits"," (",[204,411,412],{},"multipart\u002Fform-data",").",[195,415,417],{"id":416},"_413-request_too_large","413 REQUEST_TOO_LARGE",[200,419,420],{},"The request body exceeds the 64 MB limit. Compress the images or reduce the number of input images, then retry.",[190,422,424],{"id":423},"video-tasks","Video & Tasks",[195,426,428],{"id":427},"does-video-generation-use-volcengine-aksk","Does video generation use Volcengine AK\u002FSK?",[200,430,431],{},"No. Video generation uses the SilvaMux API key. Volcengine V4 signing is used only by the Volcengine-compatible asset management APIs.",[195,433,435],{"id":434},"how-do-i-query-a-video-task-result","How do I query a video task result?",[200,437,438,439,442,443,446,447,450,451,454,455,259],{},"Poll ",[204,440,441],{},"GET \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F:id"," until ",[204,444,445],{},"status"," becomes ",[204,448,449],{},"succeed"," (read ",[204,452,453],{},"result.video_url",") or ",[204,456,457],{},"failed",[195,459,461],{"id":460},"_403-model_access_denied","403 MODEL_ACCESS_DENIED",[200,463,464],{},"Your organization lacks the permission flags required by the model; ask an administrator to enable them.",[195,466,468,469,472],{"id":467},"what-does-the-expired-task-status-mean","What does the ",[204,470,471],{},"expired"," task status mean?",[200,474,475],{},"A task expires when it is not queried for a long time or times out before completing; create a new task.",{"title":477,"searchDepth":478,"depth":478,"links":479},"",2,[480,496,501,505],{"id":192,"depth":478,"text":193,"children":481},[482,484,485,487,489,491,492,493,494,495],{"id":197,"depth":483,"text":198},3,{"id":242,"depth":483,"text":243},{"id":262,"depth":483,"text":486},"What goes in the model field?",{"id":285,"depth":483,"text":488},"Is the legacy vendor\u002Fmodel format still supported?",{"id":299,"depth":483,"text":490},"What are the Standard \u002F Pro tiers? Do I need @tune?",{"id":316,"depth":483,"text":317},{"id":327,"depth":483,"text":328},{"id":334,"depth":483,"text":335},{"id":347,"depth":483,"text":348},{"id":358,"depth":483,"text":359},{"id":368,"depth":478,"text":369,"children":497},[498,499,500],{"id":372,"depth":483,"text":373},{"id":379,"depth":483,"text":380},{"id":386,"depth":483,"text":387},{"id":393,"depth":478,"text":394,"children":502},[503,504],{"id":397,"depth":483,"text":398},{"id":416,"depth":483,"text":417},{"id":423,"depth":478,"text":424,"children":506},[507,508,509,510],{"id":427,"depth":483,"text":428},{"id":434,"depth":483,"text":435},{"id":460,"depth":483,"text":461},{"id":467,"depth":483,"text":511},"What does the expired task status mean?","Common questions about onboarding, chat, image, and video tasks.","md",{},true,"---\ntitle: FAQ\ndescription: Common questions about onboarding, chat, image, and video tasks.\n---\n\n# FAQ\n\n## Onboarding & Account\n\n### What is the Base URL and where do I find it?\n\nThe Base URL is the access domain, filled into the docs examples automatically per deployment at build time. For example, the CN site API base URL looks like `https:\u002F\u002Fwww.silvamux.com`. The `https:\u002F\u002Fsilvamux.io` placeholder in these docs is replaced with the actual domain when the site is built — no manual edits needed when copying examples.\n\n- Chat (OpenAI Chat Completions compatible, recommended): `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fchat\u002Fcompletions`\n- Chat unified entry (optional, cross-protocol): `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv0\u002Fchat\u002Fcompletions`\n- Chat (Anthropic format): `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv1\u002Fmessages`\n- Images, video, and 3D: `https:\u002F\u002Fsilvamux.io\u002Fapi\u002Fv3\u002F...`\n\n### Where do I create an API key? What does it look like?\n\nCreate keys on the console **API Keys** page. Keys start with `sk_live_` and are shown only once at creation; store yours as the environment variable `SILVAMUX_API_KEY`.\n\n### What goes in the `model` field?\n\nUse the model call name (the model `id` or `alias`), preferring the alias, for example `minimax-m2.5`. The model catalog API and the Model Plaza are authoritative for currently available models.\n\n### Is the legacy `vendor\u002Fmodel` format still supported?\n\nThe legacy `vendor\u002Fmodel` format still works, but new integrations should use the simpler, more stable alias.\n\n### What are the Standard \u002F Pro tiers? Do I need `@tune`?\n\nThe platform can expose the same model through different supply tiers; the `@tune` suffix marks the standard tier. All models are currently single-tier — use the alias directly without `@tune`. Dual-tier models will be flagged in the model catalog when introduced.\n\n### What if my balance runs out?\n\nTop up in the console. When the balance is insufficient, model requests return `INSUFFICIENT_BALANCE` (HTTP 402).\n\n### Does \"no discount configured\" mean it's free?\n\nNo. Without a configured discount you are billed at list price (discount factor 1). Discounts are configured by administrators per organization and pricing group.\n\n### 401 Unauthorized\n\nCheck that the API key is correct and not revoked. Gateway APIs use `Authorization: Bearer sk_live_...` or `x-api-key: sk_live_...`.\n\n### 429 RATE_LIMITED\n\nThe request hit a rate limit — wait and retry with exponential backoff. Image and video generation return `CONCURRENCY_LIMIT_EXCEEDED` when the concurrency cap is reached.\n\n### 502 UPSTREAM_*\n\nThe model side is temporarily failing; retries are reasonable. If failures persist, contact the platform with the `X-Request-Id`.\n\n## Chat & Models\n\n### If a streaming response is interrupted, am I billed twice?\n\nNo. Settled tokens are never charged twice; a retried request is billed only for its own actual usage.\n\n### Why do multimodal calls fail?\n\nSilvaMux passes images, audio, and other content through to the model. Whether the input type is supported depends on the model's capabilities; text-only models may return errors when given images or audio.\n\n### Should I use the unified entry or a compatible entry?\n\nWhen using OpenAI, Anthropic, Gemini, Volcengine, or Zhipu SDKs, prefer the matching compatible entry. Use the SilvaMux unified entry when you want to call different models across protocols through a single endpoint.\n\n## Image Generation\n\n### Do text-to-image and image editing share one API?\n\nNo. Text-to-image uses `POST \u002Fapi\u002Fv3\u002Fimages\u002Fgenerations`; image editing uses `POST \u002Fapi\u002Fv3\u002Fimages\u002Fedits` (`multipart\u002Fform-data`).\n\n### 413 REQUEST_TOO_LARGE\n\nThe request body exceeds the 64 MB limit. Compress the images or reduce the number of input images, then retry.\n\n## Video & Tasks\n\n### Does video generation use Volcengine AK\u002FSK?\n\nNo. Video generation uses the SilvaMux API key. Volcengine V4 signing is used only by the Volcengine-compatible asset management APIs.\n\n### How do I query a video task result?\n\nPoll `GET \u002Fapi\u002Fv3\u002Fcontents\u002Fgenerations\u002Ftasks\u002F:id` until `status` becomes `succeed` (read `result.video_url`) or `failed`.\n\n### 403 MODEL_ACCESS_DENIED\n\nYour organization lacks the permission flags required by the model; ask an administrator to enable them.\n\n### What does the `expired` task status mean?\n\nA task expires when it is not queried for a long time or times out before completing; create a new task.\n",[],{"title":22,"description":512},"8t5BM1jeifMeVdVDBSNEGV08wJH4c6NzMrLEthp4XWs"]