[{"data":1,"prerenderedAt":395},["ShallowReactive",2],{"navigation":3,"\u002Fapi-reference\u002Ferrors":117,"\u002Fapi-reference\u002Ferrors-surround":390},[4,28,36,63,96],{"title":5,"path":6,"stem":7,"children":8,"icon":27},"快速开始","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17,22],{"title":10,"path":6,"stem":7,"icon":11},"概览","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"零基础使用指南","\u002Fgetting-started\u002Fbeginner-guide","1.getting-started\u002F2.beginner-guide","i-lucide-list-checks",{"title":18,"path":19,"stem":20,"icon":21},"创建 API Key","\u002Fgetting-started\u002Fapi-key","1.getting-started\u002F3.api-key","i-lucide-key-round",{"title":23,"path":24,"stem":25,"icon":26},"第一条请求","\u002Fgetting-started\u002Ffirst-request","1.getting-started\u002F4.first-request","i-lucide-send","i-lucide-rocket",{"title":29,"path":30,"stem":31,"children":32,"icon":35},"软件下载","\u002Fdownloads","2.downloads\u002F1.index",[33],{"title":34,"path":30,"stem":31,"icon":35},"ChatGPT 与 CC Switch 下载","i-lucide-download",{"title":37,"icon":38,"path":39,"stem":40,"children":41,"page":62},"开发工具","i-lucide-terminal-square","\u002Fintegrations","2.integrations",[42,47,52,57],{"title":43,"path":44,"stem":45,"icon":46},"Claude Code","\u002Fintegrations\u002Fclaude-code","2.integrations\u002F1.claude-code","i-simple-icons-anthropic",{"title":48,"path":49,"stem":50,"icon":51},"Codex","\u002Fintegrations\u002Fcodex","2.integrations\u002F2.codex","i-simple-icons-openai",{"title":53,"path":54,"stem":55,"icon":56},"Gemini CLI","\u002Fintegrations\u002Fgemini-cli","2.integrations\u002F3.gemini-cli","i-simple-icons-google",{"title":58,"path":59,"stem":60,"icon":61},"OpenCode","\u002Fintegrations\u002Fopencode","2.integrations\u002F4.opencode","i-lucide-code-xml",false,{"title":64,"icon":65,"path":66,"stem":67,"children":68,"page":62},"API 参考","i-lucide-braces","\u002Fapi-reference","3.api-reference",[69,74,79,83,87,91],{"title":70,"path":71,"stem":72,"icon":73},"API 概览","\u002Fapi-reference\u002Foverview","3.api-reference\u002F1.overview","i-lucide-map",{"title":75,"path":76,"stem":77,"icon":78},"身份验证","\u002Fapi-reference\u002Fauthentication","3.api-reference\u002F2.authentication","i-lucide-shield-check",{"title":80,"path":81,"stem":82,"icon":51},"OpenAI 兼容 API","\u002Fapi-reference\u002Fopenai-compatible","3.api-reference\u002F3.openai-compatible",{"title":84,"path":85,"stem":86,"icon":46},"Anthropic Messages API","\u002Fapi-reference\u002Fanthropic","3.api-reference\u002F4.anthropic",{"title":88,"path":89,"stem":90,"icon":56},"Gemini API","\u002Fapi-reference\u002Fgemini","3.api-reference\u002F5.gemini",{"title":92,"path":93,"stem":94,"icon":95},"错误处理","\u002Fapi-reference\u002Ferrors","3.api-reference\u002F6.errors","i-lucide-triangle-alert",{"title":97,"icon":98,"path":99,"stem":100,"children":101,"page":62},"账户与计费","i-lucide-wallet-cards","\u002Faccount","4.account",[102,107,112],{"title":103,"path":104,"stem":105,"icon":106},"套餐与模型价格","\u002Faccount\u002Fmodels-pricing","4.account\u002F1.models-pricing","i-lucide-tags",{"title":108,"path":109,"stem":110,"icon":111},"计费与用量","\u002Faccount\u002Fbilling-usage","4.account\u002F2.billing-usage","i-lucide-receipt-text",{"title":113,"path":114,"stem":115,"icon":116},"常见问题","\u002Faccount\u002Ffaq","4.account\u002F3.faq","i-lucide-circle-help",{"id":118,"title":92,"body":119,"description":383,"extension":384,"links":385,"meta":386,"navigation":387,"path":93,"seo":388,"stem":94,"__hash__":389},"docs\u002F3.api-reference\u002F6.errors.md",{"type":120,"value":121,"toc":377},"minimark",[122,126,130,232,235,304,329,332,373],[123,124,125],"p",{},"当请求失败时，先记录 HTTP 状态码、返回的错误信息和请求时间，再判断是否重试。日志中不应包含完整 API Key 或敏感输入。",[127,128,129],"h2",{"id":129},"常见状态码",[131,132,133,149],"table",{},[134,135,136],"thead",{},[137,138,139,143,146],"tr",{},[140,141,142],"th",{},"状态码",[140,144,145],{},"含义",[140,147,148],{},"建议",[150,151,152,167,180,193,206,219],"tbody",{},[137,153,154,161,164],{},[155,156,157],"td",{},[158,159,160],"code",{},"400",[155,162,163],{},"请求体或参数无效",[155,165,166],{},"检查 JSON、模型 ID 和当前协议要求",[137,168,169,174,177],{},[155,170,171],{},[158,172,173],{},"401",[155,175,176],{},"API Key 缺失、无效或已失效",[155,178,179],{},"检查请求头，必要时轮换密钥",[137,181,182,187,190],{},[155,183,184],{},[158,185,186],{},"403",[155,188,189],{},"密钥或分组无权访问",[155,191,192],{},"检查模型分组与账户状态",[137,194,195,200,203],{},[155,196,197],{},[158,198,199],{},"404",[155,201,202],{},"端点或模型不存在",[155,204,205],{},"确认 Base URL、路径和模型 ID",[137,207,208,213,216],{},[155,209,210],{},[158,211,212],{},"429",[155,214,215],{},"超过速率、并发或配额限制",[155,217,218],{},"指数退避后重试，同时降低并发",[137,220,221,226,229],{},[155,222,223],{},[158,224,225],{},"5xx",[155,227,228],{},"网关或上游暂时故障",[155,230,231],{},"对幂等请求进行有上限的退避重试",[127,233,234],{"id":234},"重试建议",[236,237,242],"pre",{"className":238,"code":239,"language":240,"meta":241,"style":241},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const retryableStatus = new Set([408, 429, 500, 502, 503, 504])\n","ts","",[158,243,244],{"__ignoreMap":241},[245,246,249,253,257,261,264,268,271,275,278,281,283,286,288,291,293,296,298,301],"span",{"class":247,"line":248},"line",1,[245,250,252],{"class":251},"spNyl","const",[245,254,256],{"class":255},"sTEyZ"," retryableStatus ",[245,258,260],{"class":259},"sMK4o","=",[245,262,263],{"class":259}," new",[245,265,267],{"class":266},"s2Zo4"," Set",[245,269,270],{"class":255},"([",[245,272,274],{"class":273},"sbssI","408",[245,276,277],{"class":259},",",[245,279,280],{"class":273}," 429",[245,282,277],{"class":259},[245,284,285],{"class":273}," 500",[245,287,277],{"class":259},[245,289,290],{"class":273}," 502",[245,292,277],{"class":259},[245,294,295],{"class":273}," 503",[245,297,277],{"class":259},[245,299,300],{"class":273}," 504",[245,302,303],{"class":255},"])\n",[305,306,307,311,314,326],"ul",{},[308,309,310],"li",{},"使用指数退避并增加少量随机抖动。",[308,312,313],{},"限制最大重试次数和总耗时。",[308,315,316,317,319,320,322,323,325],{},"不要自动重试明确的 ",[158,318,160],{},"、",[158,321,173],{}," 或 ",[158,324,186],{},"。",[308,327,328],{},"对可能产生副作用的请求，先确认幂等性。",[127,330,331],{"id":331},"排查步骤",[333,334,335,339,342,345,352,355,367,370],"steps",{},[336,337,338],"h3",{"id":338},"用最小请求复现",[123,340,341],{},"使用 curl 排除 SDK 和应用层代码的影响。",[336,343,344],{"id":344},"确认模型与分组",[123,346,347,348,351],{},"通过 ",[158,349,350],{},"\u002Fv1\u002Fmodels"," 或控制台确认密钥可用模型。",[336,353,354],{"id":354},"检查用量记录",[123,356,357,358,366],{},"在 ",[359,360,365],"a",{"href":361,"rel":362,"target":364},"https:\u002F\u002Fpaytok.ai\u002Fusage",[363],"nofollow","_blank","用量记录"," 中查看请求状态与计费信息。",[336,368,369],{"id":369},"联系支持",[123,371,372],{},"提供发生时间、请求端点、状态码和已脱敏的错误信息。",[374,375,376],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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":241,"searchDepth":248,"depth":378,"links":379},2,[380,381,382],{"id":129,"depth":378,"text":129},{"id":234,"depth":378,"text":234},{"id":331,"depth":378,"text":331},"识别常见 HTTP 错误，并为超时、限流和上游故障设计重试策略。","md",null,{},{"icon":95},{"title":92,"description":383},"WlHSSIgwKDdbLy44dZMIUCsgRT8vJx93mY7EEd1HU2o",[391,393],{"title":88,"path":89,"stem":90,"description":392,"icon":56,"children":-1},"使用 Gemini API 协议和 Gemini CLI 调用派拓。",{"title":103,"path":104,"stem":105,"description":394,"icon":106,"children":-1},"查看派拓订阅套餐、可用模型与标准 Token 价格。",1788594882175]