HTTP 429或X-RateLimit-Remaining: 0表示超出速率限制，具体包括：一、账户等级限值（免费0.83QPS/50RPM，专业3.3QPS/200RPM，定制16QPS/1000RPM）；二、环境配额（开发10QPS、测试50QPS、生产100QPS）；三、Token滚动配额（免费5万输入+2.5万输出/小时，专业30万+15万，定制按合同）；四、IP白名单规则（单IP独占配额，多IP可浮动借用至120%总额度）；五、突发机制（5分钟内QPS提至2–3倍，需手动启用且冷却30分钟）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用DeepSeek API时收到HTTP 429状态码或响应头中包含X-RateLimit-Remaining: 0，则说明当前请求已超出平台设定的速率限制。以下是针对不同账户类型与环境配置的具体限值说明：
一、按账户等级划分的QPS与RPM限制
DeepSeek对API调用实施基于账户等级的全局速率控制，所有密钥共享同一租户配额池，不受IP数量或密钥个数影响。
1、免费版用户：最大0.83次/秒（QPS），等效于50次/分钟（RPM），单次请求间隔不得低于20毫秒。
2、专业版用户：标称QPS软限为3.3次/秒，对应RPM上限为200次/分钟；持续高负载下系统可能动态降频至2.5次/秒。
3、定制版用户：QPS峰值可达16次/秒，对应RPM为1000次/分钟，但必须启用IP白名单与租户隔离策略，否则仍按专业版限流执行。
二、按运行环境区分的QPS配额
API Key在创建时需绑定运行环境，各环境拥有独立QPS配额，不可跨环境共享。
1、开发环境：默认QPS为10次/秒，仅限控制台调试调用，不支持批量脚本调用。
2、测试环境：QPS为50次/秒，允许自动化测试流程接入，须绑定测试域名白名单。
3、生产环境：初始QPS为100次/秒，须完成实名认证与业务场景备案后方可启用。
三、Token级滚动配额限制
除请求频次外，DeepSeek按实际消耗的输入与输出Token数量进行双重计量，采用每小时重置的滚动窗口模型。
1、免费版：每小时最多处理50,000输入Tokens + 25,000输出Tokens，超出后返回429并附带X-RateLimit-Remaining头信息。
2、专业版：每小时配额为300,000输入Tokens + 150,000输出Tokens，支持通过控制台申请临时提升至500,000/250,000（有效期24小时）。
3、定制版：按合同约定执行，典型配置为2,000,000输入Tokens + 1,000,000输出Tokens/小时，超限时触发异步告警而非即时阻断。
四、IP白名单下的配额叠加规则
启用IP白名单后，系统为每个登记IP单独维护速率与Token计数器，但所有IP共享租户总配额池。
1、未启用白名单时：全部调用统一计入主租户配额，无论来源IP是否相同。
2、启用白名单且仅登记1个IP：该IP独占全部配额，其他IP请求直接拒绝，响应头含X-RateLimit-Policy: ip-whitelist-enforced。
3、启用白名单并登记多个IP：各IP初始配额为租户总额度的1/N（N为登记IP数），允许浮动借用——某IP空闲时，其余IP可临时借用其未使用额度，上限不超过租户总额度的120%。
五、突发配额与弹性机制
部分付费套餐支持突发配额模式，允许在限定时间窗内突破基础QPS限制。
1、突发窗口通常为5分钟，期间QPS可临时提升至基础值的2–3倍，具体倍率依套餐而定。
2、突发配额不占用常规小时级Token额度，但需提前在控制台启用“突发模式”开关。
3、每次突发使用后需冷却30分钟，冷却期内无法再次触发突发配额。
