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