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