[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-nav-zh":3,"docs-zh-getting-started\u002Frate-limits":144},[4,52,69,119,136,140],{"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},"模型接口","\u002Fmodels","4.models",[74,107],{"title":75,"path":76,"stem":77,"children":78,"page":43},"文本生成","\u002Fmodels\u002Fchat","4.models\u002F1.chat",[79,83,87,91,95,99,103],{"title":80,"path":81,"stem":82},"概述","\u002Fmodels\u002Fchat\u002Foverview","4.models\u002F1.chat\u002F1.overview",{"title":84,"path":85,"stem":86},"OpenAI 兼容接口","\u002Fmodels\u002Fchat\u002Fopenai","4.models\u002F1.chat\u002F2.openai",{"title":88,"path":89,"stem":90},"Anthropic 兼容","\u002Fmodels\u002Fchat\u002Fanthropic","4.models\u002F1.chat\u002F3.anthropic",{"title":92,"path":93,"stem":94},"Volcengine 兼容","\u002Fmodels\u002Fchat\u002Fvolcengine","4.models\u002F1.chat\u002F4.volcengine",{"title":96,"path":97,"stem":98},"智谱兼容","\u002Fmodels\u002Fchat\u002Fzhipu","4.models\u002F1.chat\u002F5.zhipu",{"title":100,"path":101,"stem":102},"SilvaMux 统一入口","\u002Fmodels\u002Fchat\u002Funified","4.models\u002F1.chat\u002F6.unified",{"title":104,"path":105,"stem":106},"多模态输入","\u002Fmodels\u002Fchat\u002Fmultimodal","4.models\u002F1.chat\u002F7.multimodal",{"title":108,"path":109,"stem":110,"children":111,"page":43},"图片生成","\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},"图片生成接口","\u002Fmodels\u002Fimages\u002Fgeneration","4.models\u002F2.images\u002F2.generation",{"title":120,"path":121,"stem":122,"children":123,"page":43},"用量与余额","\u002Fusage-and-balance","5.usage-and-balance",[124,128,132],{"title":125,"path":126,"stem":127},"查询余额","\u002Fusage-and-balance\u002Fbalance","5.usage-and-balance\u002F1.balance",{"title":129,"path":130,"stem":131},"查询用量","\u002Fusage-and-balance\u002Fusage","5.usage-and-balance\u002F2.usage",{"title":133,"path":134,"stem":135},"查询单次请求消耗","\u002Fusage-and-balance\u002Frequest-usage","5.usage-and-balance\u002F3.request-usage",{"title":137,"path":138,"stem":139},"错误码参考","\u002Ferrors","6.errors",{"title":141,"path":142,"stem":143},"文档首页","\u002F","index",{"id":145,"title":45,"body":146,"description":324,"extension":325,"meta":326,"navigation":327,"path":46,"rawbody":328,"requiredFlags":329,"seo":330,"stem":47,"__hash__":331},"docs\u002F1.getting-started\u002F3.rate-limits.md",{"type":147,"value":148,"toc":317},"minimark",[149,152,165,170,187,194,202,228,231,234,282,285,288,291,303],[150,151,45],"h1",{"id":45},[153,154,155,156,160,161,164],"p",{},"SilvaMux 对模型调用施加两层限制：",[157,158,159],"strong",{},"请求速率","（每分钟请求数）和",[157,162,163],{},"生成并发","（图片\u002F视频同时进行的任务数）。超限时请求返回 429。",[166,167,169],"h2",{"id":168},"请求速率rpm","请求速率（RPM）",[171,172,173,181,184],"ul",{},[174,175,176,177,180],"li",{},"限流按",[157,178,179],{},"组织","计：同一组织下所有 API Key 的请求合并计数，不区分 Key 或用户。",[174,182,183],{},"默认配额为每分钟 3600 个请求；如需更高配额请联系平台。",[174,185,186],{},"计数窗口为 UTC 分钟固定窗口。",[188,189,191],"alert",{"type":190},"info",[153,192,193],{},"限流保护在鉴权之后、扣费之前执行；触发限流的请求不会产生扣费。",[153,195,196,197,201],{},"超限返回 HTTP 429，错误码 ",[198,199,200],"code",{},"RATE_LIMITED","，错误体按接口协议渲染：",[171,203,204,210,216,222],{},[174,205,206,207],{},"OpenAI 格式：",[198,208,209],{},"{\"error\":{\"message\":\"rate limited\",\"type\":\"gateway_error\",\"code\":\"RATE_LIMITED\"}}",[174,211,212,213],{},"Anthropic 格式：",[198,214,215],{},"{\"type\":\"error\",\"error\":{\"type\":\"rate_limit_error\",\"message\":\"rate limited\"}}",[174,217,218,219],{},"Gemini 格式：",[198,220,221],{},"\"status\":\"RESOURCE_EXHAUSTED\"",[174,223,224,225],{},"Volcengine 格式：",[198,226,227],{},"{\"error\":{\"code\":\"RATE_LIMITED\",\"message\":\"rate limited\"}}",[166,229,230],{"id":230},"生成并发上限",[153,232,233],{},"图片和视频生成为异步任务，并发上限按组织配置（默认 5），由管理员调整：",[235,236,237,253],"table",{},[238,239,240],"thead",{},[241,242,243,247,250],"tr",{},[244,245,246],"th",{},"能力",[244,248,249],{},"错误码",[244,251,252],{},"说明",[254,255,256,270],"tbody",{},[241,257,258,261,267],{},[259,260,108],"td",{},[259,262,263,266],{},[198,264,265],{},"CONCURRENCY_LIMIT_EXCEEDED","（429）",[259,268,269],{},"同时进行的图片生成任务超过上限",[241,271,272,275,279],{},[259,273,274],{},"视频生成",[259,276,277,266],{},[198,278,265],{},[259,280,281],{},"同时进行的视频生成任务超过上限",[153,283,284],{},"超限后等待进行中的任务完成再提交新任务。",[166,286,287],{"id":287},"超限重试建议",[153,289,290],{},"收到 429 时使用指数退避重试（如 1s、2s、4s...），并检查：",[171,292,293,298],{},[174,294,295,297],{},[198,296,200],{},"：请求频率超过 RPM 配额，降低请求速率。",[174,299,300,302],{},[198,301,265],{},"：等待生成任务完成，或联系平台提升并发上限。",[188,304,306],{"type":305},"warning",[153,307,308,309,312,313,316],{},"平台不返回 ",[198,310,311],{},"X-RateLimit-*"," 或 ",[198,314,315],{},"Retry-After"," 响应头，客户端应以错误码为准自行实现退避。",{"title":318,"searchDepth":319,"depth":319,"links":320},"",2,[321,322,323],{"id":168,"depth":319,"text":169},{"id":230,"depth":319,"text":230},{"id":287,"depth":319,"text":287},"请求速率限制、生成并发上限和超限错误处理。","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":324},"MAa0ONJ1ahBvro4U4z8n72-wtkkBbHaRDLoRRWvLVik"]