[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-en":3,"docs-en-errors":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":137,"body":146,"description":852,"extension":853,"meta":854,"navigation":855,"path":138,"rawbody":856,"requiredFlags":857,"seo":858,"stem":139,"__hash__":859},"docs_en\u002F6.errors.md",{"type":147,"value":148,"toc":842},"minimark",[149,153,157,162,169,249,252,256,259,467,472,511,515,552,555,607,611,614,659,666,742,753,757,820,824,838],[150,151,137],"h1",{"id":152},"error-codes",[154,155,156],"p",{},"SilvaMux's error format depends on the API type. This page summarizes the common error format, model-call error codes, and retry advice.",[158,159,161],"h2",{"id":160},"gateway-api-errors-model-calls","Gateway API Errors (Model Calls)",[154,163,164,165,168],{},"The error format of chat, image, and video model APIs is determined by the model protocol, rendered in one of four shapes — OpenAI \u002F Anthropic \u002F Gemini \u002F Volcengine — with a unified ",[166,167,166],"code",{}," string.",[170,171,176],"pre",{"className":172,"code":173,"language":174,"meta":175,"style":175},"language-json shiki shiki-themes github-light github-dark","{\n  \"error\": {\n    \"message\": \"Detailed error message\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n","json","",[166,177,178,187,197,213,226,237,243],{"__ignoreMap":175},[179,180,183],"span",{"class":181,"line":182},"line",1,[179,184,186],{"class":185},"sVt8B","{\n",[179,188,190,194],{"class":181,"line":189},2,[179,191,193],{"class":192},"sj4cs","  \"error\"",[179,195,196],{"class":185},": {\n",[179,198,200,203,206,210],{"class":181,"line":199},3,[179,201,202],{"class":192},"    \"message\"",[179,204,205],{"class":185},": ",[179,207,209],{"class":208},"sZZnC","\"Detailed error message\"",[179,211,212],{"class":185},",\n",[179,214,216,219,221,224],{"class":181,"line":215},4,[179,217,218],{"class":192},"    \"type\"",[179,220,205],{"class":185},[179,222,223],{"class":208},"\"gateway_error\"",[179,225,212],{"class":185},[179,227,229,232,234],{"class":181,"line":228},5,[179,230,231],{"class":192},"    \"code\"",[179,233,205],{"class":185},[179,235,236],{"class":208},"\"ERROR_CODE\"\n",[179,238,240],{"class":181,"line":239},6,[179,241,242],{"class":185},"  }\n",[179,244,246],{"class":181,"line":245},7,[179,247,248],{"class":185},"}\n",[154,250,251],{},"When the model side returns 4xx\u002F5xx, SilvaMux passes the error response through after sanitization, preserving the HTTP status code; no charges are incurred in that case.",[158,253,255],{"id":254},"gateway-api-error-codes","Gateway API Error Codes",[154,257,258],{},"Chat, image, and video model calls share the following error codes:",[260,261,262,278],"table",{},[263,264,265],"thead",{},[266,267,268,272,275],"tr",{},[269,270,271],"th",{},"Code",[269,273,274],{},"HTTP",[269,276,277],{},"Description",[279,280,281,299,311,323,335,348,361,374,387,405,418,430,442,454],"tbody",{},[266,282,283,289,292],{},[284,285,286],"td",{},[166,287,288],{},"MODEL_REQUIRED",[284,290,291],{},"400",[284,293,294,295,298],{},"Request body missing the ",[166,296,297],{},"model"," field",[266,300,301,306,308],{},[284,302,303],{},[166,304,305],{},"MODEL_NOT_FOUND",[284,307,291],{},[284,309,310],{},"Model does not exist or is unavailable",[266,312,313,318,320],{},[284,314,315],{},[166,316,317],{},"INVALID_REQUEST",[284,319,291],{},[284,321,322],{},"Invalid request parameters",[266,324,325,330,332],{},[284,326,327],{},[166,328,329],{},"INVALID_REQUEST_BODY",[284,331,291],{},[284,333,334],{},"Failed to parse the request body",[266,336,337,342,345],{},[284,338,339],{},[166,340,341],{},"UNAUTHORIZED",[284,343,344],{},"401",[284,346,347],{},"Authentication failed (invalid API key\u002FJWT)",[266,349,350,355,358],{},[284,351,352],{},[166,353,354],{},"MODEL_ACCESS_DENIED",[284,356,357],{},"403",[284,359,360],{},"Organization lacks the permission flags required by the model",[266,362,363,368,371],{},[284,364,365],{},[166,366,367],{},"INSUFFICIENT_BALANCE",[284,369,370],{},"402",[284,372,373],{},"Insufficient balance",[266,375,376,381,384],{},[284,377,378],{},[166,379,380],{},"PRE_DEDUCT_FAILED",[284,382,383],{},"400\u002F402",[284,385,386],{},"Pre-deduction failed (bad parameters = 400, storage failure = 402)",[266,388,389,394,397],{},[284,390,391],{},[166,392,393],{},"RATE_LIMITED",[284,395,396],{},"429",[284,398,399,400,404],{},"Rate limit hit (see ",[401,402,45],"a",{"href":403},"\u002Fen\u002Fdocs\u002Fgetting-started\u002Frate-limits",")",[266,406,407,412,415],{},[284,408,409],{},[166,410,411],{},"UPSTREAM_UNAVAILABLE",[284,413,414],{},"502",[284,416,417],{},"Failed to send the request to the model side",[266,419,420,425,427],{},[284,421,422],{},[166,423,424],{},"UPSTREAM_HTTP_ERROR",[284,426,414],{},[284,428,429],{},"Model side returned 4xx\u002F5xx",[266,431,432,437,439],{},[284,433,434],{},[166,435,436],{},"UPSTREAM_PROVIDER_ERROR",[284,438,414],{},[284,440,441],{},"Model-side business error",[266,443,444,449,451],{},[284,445,446],{},[166,447,448],{},"UPSTREAM_INVALID_RESPONSE",[284,450,414],{},[284,452,453],{},"Model-side response could not be parsed",[266,455,456,461,464],{},[284,457,458],{},[166,459,460],{},"INTERNAL",[284,462,463],{},"500",[284,465,466],{},"Internal error",[468,469,471],"h3",{"id":470},"image-generation-only","Image Generation Only",[260,473,474,484],{},[263,475,476],{},[266,477,478,480,482],{},[269,479,271],{},[269,481,274],{},[269,483,277],{},[279,485,486,499],{},[266,487,488,493,496],{},[284,489,490],{},[166,491,492],{},"REQUEST_TOO_LARGE",[284,494,495],{},"413",[284,497,498],{},"Request body exceeds 64MB",[266,500,501,506,508],{},[284,502,503],{},[166,504,505],{},"CONCURRENCY_LIMIT_EXCEEDED",[284,507,396],{},[284,509,510],{},"Image generation concurrency cap",[468,512,514],{"id":513},"video-tasks-only","Video & Tasks Only",[260,516,517,527],{},[263,518,519],{},[266,520,521,523,525],{},[269,522,271],{},[269,524,274],{},[269,526,277],{},[279,528,529,541],{},[266,530,531,536,538],{},[284,532,533],{},[166,534,535],{},"INVALID_CALLBACK_URL",[284,537,291],{},[284,539,540],{},"Invalid callback URL",[266,542,543,547,549],{},[284,544,545],{},[166,546,505],{},[284,548,396],{},[284,550,551],{},"Video generation concurrency cap",[154,553,554],{},"Task cancellation errors:",[260,556,557,567],{},[263,558,559],{},[266,560,561,563,565],{},[269,562,274],{},[269,564,271],{},[269,566,277],{},[279,568,569,582,595],{},[266,570,571,574,579],{},[284,572,573],{},"404",[284,575,576],{},[166,577,578],{},"NOT_FOUND",[284,580,581],{},"Task not found",[266,583,584,587,592],{},[284,585,586],{},"409",[284,588,589],{},[166,590,591],{},"INVALID_STATE",[284,593,594],{},"Task is not in the queued state",[266,596,597,599,604],{},[284,598,414],{},[284,600,601],{},[166,602,603],{},"UPSTREAM_CANCEL_FAILED",[284,605,606],{},"Model-side cancellation failed",[158,608,610],{"id":609},"billing-business-api-errors-management-apis","Billing \u002F Business API Errors (Management APIs)",[154,612,613],{},"Account, billing, and proprietary asset management APIs use an RFC 7807-style body:",[170,615,617],{"className":172,"code":616,"language":174,"meta":175,"style":175},"{\n  \"status\": 400,\n  \"detail\": \"Detailed error message\",\n  \"type\": \"tag:hub,2026-03:ERROR_CODE\"\n}\n",[166,618,619,623,634,645,655],{"__ignoreMap":175},[179,620,621],{"class":181,"line":182},[179,622,186],{"class":185},[179,624,625,628,630,632],{"class":181,"line":189},[179,626,627],{"class":192},"  \"status\"",[179,629,205],{"class":185},[179,631,291],{"class":192},[179,633,212],{"class":185},[179,635,636,639,641,643],{"class":181,"line":199},[179,637,638],{"class":192},"  \"detail\"",[179,640,205],{"class":185},[179,642,209],{"class":208},[179,644,212],{"class":185},[179,646,647,650,652],{"class":181,"line":215},[179,648,649],{"class":192},"  \"type\"",[179,651,205],{"class":185},[179,653,654],{"class":208},"\"tag:hub,2026-03:ERROR_CODE\"\n",[179,656,657],{"class":181,"line":228},[179,658,248],{"class":185},[154,660,661,662,665],{},"Validation errors include an ",[166,663,664],{},"errors"," array:",[170,667,669],{"className":172,"code":668,"language":174,"meta":175,"style":175},"{\n  \"status\": 422,\n  \"detail\": \"validation failed\",\n  \"type\": \"tag:hub,2026-03:VALIDATION_FAILED\",\n  \"errors\": [{\"location\": \"body.email\", \"message\": \"required\"}]\n}\n",[166,670,671,675,686,697,708,738],{"__ignoreMap":175},[179,672,673],{"class":181,"line":182},[179,674,186],{"class":185},[179,676,677,679,681,684],{"class":181,"line":189},[179,678,627],{"class":192},[179,680,205],{"class":185},[179,682,683],{"class":192},"422",[179,685,212],{"class":185},[179,687,688,690,692,695],{"class":181,"line":199},[179,689,638],{"class":192},[179,691,205],{"class":185},[179,693,694],{"class":208},"\"validation failed\"",[179,696,212],{"class":185},[179,698,699,701,703,706],{"class":181,"line":215},[179,700,649],{"class":192},[179,702,205],{"class":185},[179,704,705],{"class":208},"\"tag:hub,2026-03:VALIDATION_FAILED\"",[179,707,212],{"class":185},[179,709,710,713,716,719,721,724,727,730,732,735],{"class":181,"line":228},[179,711,712],{"class":192},"  \"errors\"",[179,714,715],{"class":185},": [{",[179,717,718],{"class":192},"\"location\"",[179,720,205],{"class":185},[179,722,723],{"class":208},"\"body.email\"",[179,725,726],{"class":185},", ",[179,728,729],{"class":192},"\"message\"",[179,731,205],{"class":185},[179,733,734],{"class":208},"\"required\"",[179,736,737],{"class":185},"}]\n",[179,739,740],{"class":181,"line":239},[179,741,248],{"class":185},[154,743,744,745,748,749,752],{},"Error codes of the customer query APIs (balance\u002Fusage) are listed in ",[401,746,125],{"href":747},"\u002Fen\u002Fdocs\u002Fusage-and-balance\u002Fbalance"," and ",[401,750,129],{"href":751},"\u002Fen\u002Fdocs\u002Fusage-and-balance\u002Fusage",".",[158,754,756],{"id":755},"retry-advice","Retry Advice",[260,758,759,769],{},[263,760,761],{},[266,762,763,766],{},[269,764,765],{},"HTTP status",[269,767,768],{},"Advice",[279,770,771,778,785,792,799,806,813],{},[266,772,773,775],{},[284,774,291],{},[284,776,777],{},"Do not retry; fix the request parameters",[266,779,780,782],{},[284,781,344],{},[284,783,784],{},"Do not retry; check your credentials",[266,786,787,789],{},[284,788,370],{},[284,790,791],{},"Do not retry; top up first",[266,793,794,796],{},[284,795,357],{},[284,797,798],{},"Do not retry; contact an administrator",[266,800,801,803],{},[284,802,396],{},[284,804,805],{},"Retry after waiting; exponential backoff recommended",[266,807,808,810],{},[284,809,463],{},[284,811,812],{},"Retrying is fine; wait 1–5 seconds between attempts",[266,814,815,817],{},[284,816,414],{},[284,818,819],{},"Retrying is fine; the model side is temporarily unavailable",[158,821,823],{"id":822},"request-ids","Request IDs",[154,825,826,827,830,831,834,835,837],{},"Every response carries an ",[166,828,829],{},"X-Request-Id"," header (format ",[166,832,833],{},"REQ-xxxx","). Provide this ID when troubleshooting. You may also set your own ",[166,836,829],{}," on requests; the system keeps it.",[839,840,841],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":175,"searchDepth":189,"depth":189,"links":843},[844,845,849,850,851],{"id":160,"depth":189,"text":161},{"id":254,"depth":189,"text":255,"children":846},[847,848],{"id":470,"depth":199,"text":471},{"id":513,"depth":199,"text":514},{"id":609,"depth":189,"text":610},{"id":755,"depth":189,"text":756},{"id":822,"depth":189,"text":823},"Error formats, model-call and management API error codes, retry advice, and request IDs.","md",{},true,"---\ntitle: Error Codes\ndescription: Error formats, model-call and management API error codes, retry advice, and request IDs.\n---\n\n# Error Codes\n\nSilvaMux's error format depends on the API type. This page summarizes the common error format, model-call error codes, and retry advice.\n\n## Gateway API Errors (Model Calls)\n\nThe error format of chat, image, and video model APIs is determined by the model protocol, rendered in one of four shapes — OpenAI \u002F Anthropic \u002F Gemini \u002F Volcengine — with a unified `code` string.\n\n```json\n{\n  \"error\": {\n    \"message\": \"Detailed error message\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n```\n\nWhen the model side returns 4xx\u002F5xx, SilvaMux passes the error response through after sanitization, preserving the HTTP status code; no charges are incurred in that case.\n\n## Gateway API Error Codes\n\nChat, image, and video model calls share the following error codes:\n\n| Code | HTTP | Description |\n| --- | --- | --- |\n| `MODEL_REQUIRED` | 400 | Request body missing the `model` field |\n| `MODEL_NOT_FOUND` | 400 | Model does not exist or is unavailable |\n| `INVALID_REQUEST` | 400 | Invalid request parameters |\n| `INVALID_REQUEST_BODY` | 400 | Failed to parse the request body |\n| `UNAUTHORIZED` | 401 | Authentication failed (invalid API key\u002FJWT) |\n| `MODEL_ACCESS_DENIED` | 403 | Organization lacks the permission flags required by the model |\n| `INSUFFICIENT_BALANCE` | 402 | Insufficient balance |\n| `PRE_DEDUCT_FAILED` | 400\u002F402 | Pre-deduction failed (bad parameters = 400, storage failure = 402) |\n| `RATE_LIMITED` | 429 | Rate limit hit (see [Rate Limits](\u002Fen\u002Fdocs\u002Fgetting-started\u002Frate-limits)) |\n| `UPSTREAM_UNAVAILABLE` | 502 | Failed to send the request to the model side |\n| `UPSTREAM_HTTP_ERROR` | 502 | Model side returned 4xx\u002F5xx |\n| `UPSTREAM_PROVIDER_ERROR` | 502 | Model-side business error |\n| `UPSTREAM_INVALID_RESPONSE` | 502 | Model-side response could not be parsed |\n| `INTERNAL` | 500 | Internal error |\n\n### Image Generation Only\n\n| Code | HTTP | Description |\n| --- | --- | --- |\n| `REQUEST_TOO_LARGE` | 413 | Request body exceeds 64MB |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | Image generation concurrency cap |\n\n### Video & Tasks Only\n\n| Code | HTTP | Description |\n| --- | --- | --- |\n| `INVALID_CALLBACK_URL` | 400 | Invalid callback URL |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | Video generation concurrency cap |\n\nTask cancellation errors:\n\n| HTTP | Code | Description |\n| --- | --- | --- |\n| 404 | `NOT_FOUND` | Task not found |\n| 409 | `INVALID_STATE` | Task is not in the queued state |\n| 502 | `UPSTREAM_CANCEL_FAILED` | Model-side cancellation failed |\n\n## Billing \u002F Business API Errors (Management APIs)\n\nAccount, billing, and proprietary asset management APIs use an RFC 7807-style body:\n\n```json\n{\n  \"status\": 400,\n  \"detail\": \"Detailed error message\",\n  \"type\": \"tag:hub,2026-03:ERROR_CODE\"\n}\n```\n\nValidation errors include an `errors` array:\n\n```json\n{\n  \"status\": 422,\n  \"detail\": \"validation failed\",\n  \"type\": \"tag:hub,2026-03:VALIDATION_FAILED\",\n  \"errors\": [{\"location\": \"body.email\", \"message\": \"required\"}]\n}\n```\n\nError codes of the customer query APIs (balance\u002Fusage) are listed in [Query Balance](\u002Fen\u002Fdocs\u002Fusage-and-balance\u002Fbalance) and [Query Usage](\u002Fen\u002Fdocs\u002Fusage-and-balance\u002Fusage).\n\n## Retry Advice\n\n| HTTP status | Advice |\n| --- | --- |\n| 400 | Do not retry; fix the request parameters |\n| 401 | Do not retry; check your credentials |\n| 402 | Do not retry; top up first |\n| 403 | Do not retry; contact an administrator |\n| 429 | Retry after waiting; exponential backoff recommended |\n| 500 | Retrying is fine; wait 1–5 seconds between attempts |\n| 502 | Retrying is fine; the model side is temporarily unavailable |\n\n## Request IDs\n\nEvery response carries an `X-Request-Id` header (format `REQ-xxxx`). Provide this ID when troubleshooting. You may also set your own `X-Request-Id` on requests; the system keeps it.\n",[],{"title":137,"description":852},"pgqDYTjVHk7P0T7RtRxMTs0Ku1OYf1_bCjMcfLjIxdI"]