[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-getting-started\u002Frate-limits":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":45,"body":169,"description":347,"extension":348,"meta":349,"navigation":350,"path":46,"rawbody":351,"requiredFlags":352,"seo":353,"stem":47,"__hash__":354},"docs\u002F1.getting-started\u002F3.rate-limits.md",{"type":170,"value":171,"toc":340},"minimark",[172,175,188,193,210,217,225,251,254,257,305,308,311,314,326],[173,174,45],"h1",{"id":45},[176,177,178,179,183,184,187],"p",{},"SilvaMux 对模型调用施加两层限制：",[180,181,182],"strong",{},"请求速率","（每分钟请求数）和",[180,185,186],{},"生成并发","（图片\u002F视频同时进行的任务数）。超限时请求返回 429。",[189,190,192],"h2",{"id":191},"请求速率rpm","请求速率（RPM）",[194,195,196,204,207],"ul",{},[197,198,199,200,203],"li",{},"限流按",[180,201,202],{},"组织","计：同一组织下所有 API Key 的请求合并计数，不区分 Key 或用户。",[197,205,206],{},"默认配额为每分钟 3600 个请求；如需更高配额请联系平台。",[197,208,209],{},"计数窗口为 UTC 分钟固定窗口。",[211,212,214],"alert",{"type":213},"info",[176,215,216],{},"限流保护在鉴权之后、扣费之前执行；触发限流的请求不会产生扣费。",[176,218,219,220,224],{},"超限返回 HTTP 429，错误码 ",[221,222,223],"code",{},"RATE_LIMITED","，错误体按接口协议渲染：",[194,226,227,233,239,245],{},[197,228,229,230],{},"OpenAI 格式：",[221,231,232],{},"{\"error\":{\"message\":\"rate limited\",\"type\":\"gateway_error\",\"code\":\"RATE_LIMITED\"}}",[197,234,235,236],{},"Anthropic 格式：",[221,237,238],{},"{\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"rate limited\"}}",[197,240,241,242],{},"Gemini 格式：",[221,243,244],{},"\"status\":\"RESOURCE_EXHAUSTED\"",[197,246,247,248],{},"Volcengine 格式：",[221,249,250],{},"{\"error\":{\"code\":\"RATE_LIMITED\",\"message\":\"rate limited\"}}",[189,252,253],{"id":253},"生成并发上限",[176,255,256],{},"图片和视频生成为异步任务，并发上限按组织配置（默认 5），由管理员调整：",[258,259,260,276],"table",{},[261,262,263],"thead",{},[264,265,266,270,273],"tr",{},[267,268,269],"th",{},"能力",[267,271,272],{},"错误码",[267,274,275],{},"说明",[277,278,279,293],"tbody",{},[264,280,281,284,290],{},[282,283,131],"td",{},[282,285,286,289],{},[221,287,288],{},"CONCURRENCY_LIMIT_EXCEEDED","（429）",[282,291,292],{},"同时进行的图片生成任务超过上限",[264,294,295,298,302],{},[282,296,297],{},"视频生成",[282,299,300,289],{},[221,301,288],{},[282,303,304],{},"同时进行的视频生成任务超过上限",[176,306,307],{},"超限后等待进行中的任务完成再提交新任务。",[189,309,310],{"id":310},"超限重试建议",[176,312,313],{},"收到 429 时使用指数退避重试（如 1s、2s、4s...），并检查：",[194,315,316,321],{},[197,317,318,320],{},[221,319,223],{},"：请求频率超过 RPM 配额，降低请求速率。",[197,322,323,325],{},[221,324,288],{},"：等待生成任务完成，或联系平台提升并发上限。",[211,327,329],{"type":328},"warning",[176,330,331,332,335,336,339],{},"平台不返回 ",[221,333,334],{},"X-RateLimit-*"," 或 ",[221,337,338],{},"Retry-After"," 响应头，客户端应以错误码为准自行实现退避。",{"title":341,"searchDepth":342,"depth":342,"links":343},"",2,[344,345,346],{"id":191,"depth":342,"text":192},{"id":253,"depth":342,"text":253},{"id":310,"depth":342,"text":310},"请求速率限制、生成并发上限和超限错误处理。","md",{},true,"---\ntitle: 限流\ndescription: 请求速率限制、生成并发上限和超限错误处理。\n---\n\n# 限流\n\nSilvaMux 对模型调用施加两层限制：**请求速率**（每分钟请求数）和**生成并发**（图片\u002F视频同时进行的任务数）。超限时请求返回 429。\n\n## 请求速率（RPM）\n\n- 限流按**组织**计：同一组织下所有 API Key 的请求合并计数，不区分 Key 或用户。\n- 默认配额为每分钟 3600 个请求；如需更高配额请联系平台。\n- 计数窗口为 UTC 分钟固定窗口。\n\n::alert{type=\"info\"}\n限流保护在鉴权之后、扣费之前执行；触发限流的请求不会产生扣费。\n::\n\n超限返回 HTTP 429，错误码 `RATE_LIMITED`，错误体按接口协议渲染：\n\n- OpenAI 格式：`{\"error\":{\"message\":\"rate limited\",\"type\":\"gateway_error\",\"code\":\"RATE_LIMITED\"}}`\n- Anthropic 格式：`{\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"rate limited\"}}`\n- Gemini 格式：`\"status\":\"RESOURCE_EXHAUSTED\"`\n- Volcengine 格式：`{\"error\":{\"code\":\"RATE_LIMITED\",\"message\":\"rate limited\"}}`\n\n## 生成并发上限\n\n图片和视频生成为异步任务，并发上限按组织配置（默认 5），由管理员调整：\n\n| 能力 | 错误码 | 说明 |\n| --- | --- | --- |\n| 图片生成 | `CONCURRENCY_LIMIT_EXCEEDED`（429） | 同时进行的图片生成任务超过上限 |\n| 视频生成 | `CONCURRENCY_LIMIT_EXCEEDED`（429） | 同时进行的视频生成任务超过上限 |\n\n超限后等待进行中的任务完成再提交新任务。\n\n## 超限重试建议\n\n收到 429 时使用指数退避重试（如 1s、2s、4s...），并检查：\n\n- `RATE_LIMITED`：请求频率超过 RPM 配额，降低请求速率。\n- `CONCURRENCY_LIMIT_EXCEEDED`：等待生成任务完成，或联系平台提升并发上限。\n\n::alert{type=\"warning\"}\n平台不返回 `X-RateLimit-*` 或 `Retry-After` 响应头，客户端应以错误码为准自行实现退避。\n::\n",[],{"title":45,"description":347},"MAa0ONJ1ahBvro4U4z8n72-wtkkBbHaRDLoRRWvLVik"]