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