[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-errors":167},[4,52,69,92,142,159,163],{"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,155],{"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},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":160,"path":161,"stem":162},"错误码参考","\u002Ferrors","6.errors",{"title":164,"path":165,"stem":166},"文档首页","\u002F","index",{"id":168,"title":160,"body":169,"description":871,"extension":872,"meta":873,"navigation":874,"path":161,"rawbody":875,"requiredFlags":876,"seo":877,"stem":162,"__hash__":878},"docs\u002F6.errors.md",{"type":170,"value":171,"toc":861},"minimark",[172,175,179,184,191,271,274,278,281,489,493,532,535,572,575,627,631,634,679,686,762,773,776,839,843,857],[173,174,160],"h1",{"id":160},[176,177,178],"p",{},"SilvaMux 的错误格式取决于接口类型。本页汇总通用错误格式、模型调用错误码与重试建议。",[180,181,183],"h2",{"id":182},"gateway-api-错误模型调用","Gateway API 错误（模型调用）",[176,185,186,187,190],{},"对话、图片、视频等模型调用接口的错误格式由模型协议决定，分 OpenAI \u002F Anthropic \u002F Gemini \u002F Volcengine 四种渲染形状，",[188,189,188],"code",{}," 字符串统一。",[192,193,198],"pre",{"className":194,"code":195,"language":196,"meta":197,"style":197},"language-json shiki shiki-themes github-light github-dark","{\n  \"error\": {\n    \"message\": \"具体错误信息\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n","json","",[188,199,200,209,219,235,248,259,265],{"__ignoreMap":197},[201,202,205],"span",{"class":203,"line":204},"line",1,[201,206,208],{"class":207},"sVt8B","{\n",[201,210,212,216],{"class":203,"line":211},2,[201,213,215],{"class":214},"sj4cs","  \"error\"",[201,217,218],{"class":207},": {\n",[201,220,222,225,228,232],{"class":203,"line":221},3,[201,223,224],{"class":214},"    \"message\"",[201,226,227],{"class":207},": ",[201,229,231],{"class":230},"sZZnC","\"具体错误信息\"",[201,233,234],{"class":207},",\n",[201,236,238,241,243,246],{"class":203,"line":237},4,[201,239,240],{"class":214},"    \"type\"",[201,242,227],{"class":207},[201,244,245],{"class":230},"\"gateway_error\"",[201,247,234],{"class":207},[201,249,251,254,256],{"class":203,"line":250},5,[201,252,253],{"class":214},"    \"code\"",[201,255,227],{"class":207},[201,257,258],{"class":230},"\"ERROR_CODE\"\n",[201,260,262],{"class":203,"line":261},6,[201,263,264],{"class":207},"  }\n",[201,266,268],{"class":203,"line":267},7,[201,269,270],{"class":207},"}\n",[176,272,273],{},"模型侧返回 4xx\u002F5xx 时，SilvaMux 会脱敏后透传错误响应，HTTP 状态码保持一致，此时不会产生扣费。",[180,275,277],{"id":276},"gateway-api-错误码","Gateway API 错误码",[176,279,280],{},"对话、图片、视频模型调用共用下列错误码：",[282,283,284,300],"table",{},[285,286,287],"thead",{},[288,289,290,294,297],"tr",{},[291,292,293],"th",{},"错误码",[291,295,296],{},"HTTP",[291,298,299],{},"说明",[301,302,303,321,333,345,357,370,383,396,409,427,440,452,464,476],"tbody",{},[288,304,305,311,314],{},[306,307,308],"td",{},[188,309,310],{},"MODEL_REQUIRED",[306,312,313],{},"400",[306,315,316,317,320],{},"请求体缺少 ",[188,318,319],{},"model"," 字段",[288,322,323,328,330],{},[306,324,325],{},[188,326,327],{},"MODEL_NOT_FOUND",[306,329,313],{},[306,331,332],{},"模型不存在或不可用",[288,334,335,340,342],{},[306,336,337],{},[188,338,339],{},"INVALID_REQUEST",[306,341,313],{},[306,343,344],{},"请求参数无效",[288,346,347,352,354],{},[306,348,349],{},[188,350,351],{},"INVALID_REQUEST_BODY",[306,353,313],{},[306,355,356],{},"请求体解析失败",[288,358,359,364,367],{},[306,360,361],{},[188,362,363],{},"UNAUTHORIZED",[306,365,366],{},"401",[306,368,369],{},"认证失败（API Key\u002FJWT 无效）",[288,371,372,377,380],{},[306,373,374],{},[188,375,376],{},"MODEL_ACCESS_DENIED",[306,378,379],{},"403",[306,381,382],{},"组织缺少该模型所需权限标志",[288,384,385,390,393],{},[306,386,387],{},[188,388,389],{},"INSUFFICIENT_BALANCE",[306,391,392],{},"402",[306,394,395],{},"余额不足",[288,397,398,403,406],{},[306,399,400],{},[188,401,402],{},"PRE_DEDUCT_FAILED",[306,404,405],{},"400\u002F402",[306,407,408],{},"预扣费失败（参数错误=400，落库失败=402）",[288,410,411,416,419],{},[306,412,413],{},[188,414,415],{},"RATE_LIMITED",[306,417,418],{},"429",[306,420,421,422,426],{},"触发限流（见",[423,424,45],"a",{"href":425},"\u002Fzh-cn\u002Fdocs\u002Fgetting-started\u002Frate-limits","）",[288,428,429,434,437],{},[306,430,431],{},[188,432,433],{},"UPSTREAM_UNAVAILABLE",[306,435,436],{},"502",[306,438,439],{},"模型侧请求发送失败",[288,441,442,447,449],{},[306,443,444],{},[188,445,446],{},"UPSTREAM_HTTP_ERROR",[306,448,436],{},[306,450,451],{},"模型侧返回 4xx\u002F5xx",[288,453,454,459,461],{},[306,455,456],{},[188,457,458],{},"UPSTREAM_PROVIDER_ERROR",[306,460,436],{},[306,462,463],{},"模型侧业务错误",[288,465,466,471,473],{},[306,467,468],{},[188,469,470],{},"UPSTREAM_INVALID_RESPONSE",[306,472,436],{},[306,474,475],{},"模型侧响应无法解析",[288,477,478,483,486],{},[306,479,480],{},[188,481,482],{},"INTERNAL",[306,484,485],{},"500",[306,487,488],{},"内部错误",[490,491,492],"h3",{"id":492},"图片生成特有",[282,494,495,505],{},[285,496,497],{},[288,498,499,501,503],{},[291,500,293],{},[291,502,296],{},[291,504,299],{},[301,506,507,520],{},[288,508,509,514,517],{},[306,510,511],{},[188,512,513],{},"REQUEST_TOO_LARGE",[306,515,516],{},"413",[306,518,519],{},"请求体超过 64MB",[288,521,522,527,529],{},[306,523,524],{},[188,525,526],{},"CONCURRENCY_LIMIT_EXCEEDED",[306,528,418],{},[306,530,531],{},"图片生成并发上限",[490,533,534],{"id":534},"视频与任务特有",[282,536,537,547],{},[285,538,539],{},[288,540,541,543,545],{},[291,542,293],{},[291,544,296],{},[291,546,299],{},[301,548,549,561],{},[288,550,551,556,558],{},[306,552,553],{},[188,554,555],{},"INVALID_CALLBACK_URL",[306,557,313],{},[306,559,560],{},"回调 URL 无效",[288,562,563,567,569],{},[306,564,565],{},[188,566,526],{},[306,568,418],{},[306,570,571],{},"视频生成并发上限",[176,573,574],{},"取消任务的错误：",[282,576,577,587],{},[285,578,579],{},[288,580,581,583,585],{},[291,582,296],{},[291,584,293],{},[291,586,299],{},[301,588,589,602,615],{},[288,590,591,594,599],{},[306,592,593],{},"404",[306,595,596],{},[188,597,598],{},"NOT_FOUND",[306,600,601],{},"任务不存在",[288,603,604,607,612],{},[306,605,606],{},"409",[306,608,609],{},[188,610,611],{},"INVALID_STATE",[306,613,614],{},"任务不在 queued 状态",[288,616,617,619,624],{},[306,618,436],{},[306,620,621],{},[188,622,623],{},"UPSTREAM_CANCEL_FAILED",[306,625,626],{},"模型侧取消失败",[180,628,630],{"id":629},"billing-business-api-错误管理接口","Billing \u002F Business API 错误（管理接口）",[176,632,633],{},"账户、计费、自有素材等管理接口使用 RFC 7807 风格：",[192,635,637],{"className":194,"code":636,"language":196,"meta":197,"style":197},"{\n  \"status\": 400,\n  \"detail\": \"具体错误信息\",\n  \"type\": \"tag:hub,2026-03:ERROR_CODE\"\n}\n",[188,638,639,643,654,665,675],{"__ignoreMap":197},[201,640,641],{"class":203,"line":204},[201,642,208],{"class":207},[201,644,645,648,650,652],{"class":203,"line":211},[201,646,647],{"class":214},"  \"status\"",[201,649,227],{"class":207},[201,651,313],{"class":214},[201,653,234],{"class":207},[201,655,656,659,661,663],{"class":203,"line":221},[201,657,658],{"class":214},"  \"detail\"",[201,660,227],{"class":207},[201,662,231],{"class":230},[201,664,234],{"class":207},[201,666,667,670,672],{"class":203,"line":237},[201,668,669],{"class":214},"  \"type\"",[201,671,227],{"class":207},[201,673,674],{"class":230},"\"tag:hub,2026-03:ERROR_CODE\"\n",[201,676,677],{"class":203,"line":250},[201,678,270],{"class":207},[176,680,681,682,685],{},"验证错误包含 ",[188,683,684],{},"errors"," 数组：",[192,687,689],{"className":194,"code":688,"language":196,"meta":197,"style":197},"{\n  \"status\": 422,\n  \"detail\": \"validation failed\",\n  \"type\": \"tag:hub,2026-03:VALIDATION_FAILED\",\n  \"errors\": [{\"location\": \"body.email\", \"message\": \"required\"}]\n}\n",[188,690,691,695,706,717,728,758],{"__ignoreMap":197},[201,692,693],{"class":203,"line":204},[201,694,208],{"class":207},[201,696,697,699,701,704],{"class":203,"line":211},[201,698,647],{"class":214},[201,700,227],{"class":207},[201,702,703],{"class":214},"422",[201,705,234],{"class":207},[201,707,708,710,712,715],{"class":203,"line":221},[201,709,658],{"class":214},[201,711,227],{"class":207},[201,713,714],{"class":230},"\"validation failed\"",[201,716,234],{"class":207},[201,718,719,721,723,726],{"class":203,"line":237},[201,720,669],{"class":214},[201,722,227],{"class":207},[201,724,725],{"class":230},"\"tag:hub,2026-03:VALIDATION_FAILED\"",[201,727,234],{"class":207},[201,729,730,733,736,739,741,744,747,750,752,755],{"class":203,"line":250},[201,731,732],{"class":214},"  \"errors\"",[201,734,735],{"class":207},": [{",[201,737,738],{"class":214},"\"location\"",[201,740,227],{"class":207},[201,742,743],{"class":230},"\"body.email\"",[201,745,746],{"class":207},", ",[201,748,749],{"class":214},"\"message\"",[201,751,227],{"class":207},[201,753,754],{"class":230},"\"required\"",[201,756,757],{"class":207},"}]\n",[201,759,760],{"class":203,"line":261},[201,761,270],{"class":207},[176,763,764,765,768,769,772],{},"客户查询接口（余额\u002F用量）的错误码见",[423,766,148],{"href":767},"\u002Fzh-cn\u002Fdocs\u002Fusage-and-balance\u002Fbalance","与",[423,770,152],{"href":771},"\u002Fzh-cn\u002Fdocs\u002Fusage-and-balance\u002Fusage","。",[180,774,775],{"id":775},"重试建议",[282,777,778,788],{},[285,779,780],{},[288,781,782,785],{},[291,783,784],{},"HTTP 状态码",[291,786,787],{},"建议",[301,789,790,797,804,811,818,825,832],{},[288,791,792,794],{},[306,793,313],{},[306,795,796],{},"不要重试，修正请求参数",[288,798,799,801],{},[306,800,366],{},[306,802,803],{},"不要重试，检查认证信息",[288,805,806,808],{},[306,807,392],{},[306,809,810],{},"不要重试，充值后再试",[288,812,813,815],{},[306,814,379],{},[306,816,817],{},"不要重试，联系管理员",[288,819,820,822],{},[306,821,418],{},[306,823,824],{},"等待后重试，建议指数退避",[288,826,827,829],{},[306,828,485],{},[306,830,831],{},"可以重试，建议间隔 1-5 秒",[288,833,834,836],{},[306,835,436],{},[306,837,838],{},"可以重试，模型侧暂时不可用",[180,840,842],{"id":841},"请求-id","请求 ID",[176,844,845,846,849,850,853,854,856],{},"每个请求返回 ",[188,847,848],{},"X-Request-Id"," header（格式 ",[188,851,852],{},"REQ-xxxx","）。排查问题时提供此 ID。你也可以在请求中自行设置 ",[188,855,848],{},"，系统会沿用。",[858,859,860],"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":197,"searchDepth":211,"depth":211,"links":862},[863,864,868,869,870],{"id":182,"depth":211,"text":183},{"id":276,"depth":211,"text":277,"children":865},[866,867],{"id":492,"depth":221,"text":492},{"id":534,"depth":221,"text":534},{"id":629,"depth":211,"text":630},{"id":775,"depth":211,"text":775},{"id":841,"depth":211,"text":842},"错误格式、模型调用与管理接口错误码、重试建议和 Request ID。","md",{},true,"---\ntitle: 错误码参考\ndescription: 错误格式、模型调用与管理接口错误码、重试建议和 Request ID。\n---\n\n# 错误码参考\n\nSilvaMux 的错误格式取决于接口类型。本页汇总通用错误格式、模型调用错误码与重试建议。\n\n## Gateway API 错误（模型调用）\n\n对话、图片、视频等模型调用接口的错误格式由模型协议决定，分 OpenAI \u002F Anthropic \u002F Gemini \u002F Volcengine 四种渲染形状，`code` 字符串统一。\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误信息\",\n    \"type\": \"gateway_error\",\n    \"code\": \"ERROR_CODE\"\n  }\n}\n```\n\n模型侧返回 4xx\u002F5xx 时，SilvaMux 会脱敏后透传错误响应，HTTP 状态码保持一致，此时不会产生扣费。\n\n## Gateway API 错误码\n\n对话、图片、视频模型调用共用下列错误码：\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `MODEL_REQUIRED` | 400 | 请求体缺少 `model` 字段 |\n| `MODEL_NOT_FOUND` | 400 | 模型不存在或不可用 |\n| `INVALID_REQUEST` | 400 | 请求参数无效 |\n| `INVALID_REQUEST_BODY` | 400 | 请求体解析失败 |\n| `UNAUTHORIZED` | 401 | 认证失败（API Key\u002FJWT 无效） |\n| `MODEL_ACCESS_DENIED` | 403 | 组织缺少该模型所需权限标志 |\n| `INSUFFICIENT_BALANCE` | 402 | 余额不足 |\n| `PRE_DEDUCT_FAILED` | 400\u002F402 | 预扣费失败（参数错误=400，落库失败=402） |\n| `RATE_LIMITED` | 429 | 触发限流（见[限流](\u002Fzh-cn\u002Fdocs\u002Fgetting-started\u002Frate-limits)） |\n| `UPSTREAM_UNAVAILABLE` | 502 | 模型侧请求发送失败 |\n| `UPSTREAM_HTTP_ERROR` | 502 | 模型侧返回 4xx\u002F5xx |\n| `UPSTREAM_PROVIDER_ERROR` | 502 | 模型侧业务错误 |\n| `UPSTREAM_INVALID_RESPONSE` | 502 | 模型侧响应无法解析 |\n| `INTERNAL` | 500 | 内部错误 |\n\n### 图片生成特有\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `REQUEST_TOO_LARGE` | 413 | 请求体超过 64MB |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | 图片生成并发上限 |\n\n### 视频与任务特有\n\n| 错误码 | HTTP | 说明 |\n| --- | --- | --- |\n| `INVALID_CALLBACK_URL` | 400 | 回调 URL 无效 |\n| `CONCURRENCY_LIMIT_EXCEEDED` | 429 | 视频生成并发上限 |\n\n取消任务的错误：\n\n| HTTP | 错误码 | 说明 |\n| --- | --- | --- |\n| 404 | `NOT_FOUND` | 任务不存在 |\n| 409 | `INVALID_STATE` | 任务不在 queued 状态 |\n| 502 | `UPSTREAM_CANCEL_FAILED` | 模型侧取消失败 |\n\n## Billing \u002F Business API 错误（管理接口）\n\n账户、计费、自有素材等管理接口使用 RFC 7807 风格：\n\n```json\n{\n  \"status\": 400,\n  \"detail\": \"具体错误信息\",\n  \"type\": \"tag:hub,2026-03:ERROR_CODE\"\n}\n```\n\n验证错误包含 `errors` 数组：\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\n客户查询接口（余额\u002F用量）的错误码见[查询余额](\u002Fzh-cn\u002Fdocs\u002Fusage-and-balance\u002Fbalance)与[查询用量](\u002Fzh-cn\u002Fdocs\u002Fusage-and-balance\u002Fusage)。\n\n## 重试建议\n\n| HTTP 状态码 | 建议 |\n| --- | --- |\n| 400 | 不要重试，修正请求参数 |\n| 401 | 不要重试，检查认证信息 |\n| 402 | 不要重试，充值后再试 |\n| 403 | 不要重试，联系管理员 |\n| 429 | 等待后重试，建议指数退避 |\n| 500 | 可以重试，建议间隔 1-5 秒 |\n| 502 | 可以重试，模型侧暂时不可用 |\n\n## 请求 ID\n\n每个请求返回 `X-Request-Id` header（格式 `REQ-xxxx`）。排查问题时提供此 ID。你也可以在请求中自行设置 `X-Request-Id`，系统会沿用。\n",[],{"title":160,"description":871},"LnfZJsDCtLu2GOTRlmeeAOhx2lZTBRRByl_cdesUjws"]