Qoder API调用受Credits配额、并发会话数及CLI节流三重限制：单账号300 Credits/天，最多3个并发会话，CLI每秒限2次请求且强制800ms间隔，超限返回429或CREDITS_EXHAUSTED错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过程序化方式调用 Qoder 提供的 API 接口，但收到限流响应或请求被拒绝，则可能是由于超出平台设定的调用频率阈值。以下是针对 Qoder API 调用频率限制的详细说明：
一、Qoder API 默认调用频率限制
Qoder 并未对外公开独立的 HTTP API 服务接口，其核心能力通过本地 IDE 插件与 CLI 工具实现，所有模型调用均经由 QoderWork 云服务网关统一调度，并受 Credits 消耗机制 与 实时并发会话数限制 双重约束。当前（2026年5月）实际执行的默认限制如下：
1、单个用户账号默认配额为 300 Credits / 天，新注册用户自动获赠该额度；
2、每轮智能体（Agent）任务平均消耗 15–80 Credits，具体取决于代码仓库规模、上下文长度与操作复杂度；
3、同一账号下最多允许 3 个并发活跃会话（含 Ask 模式与 Agent 模式），超出后新会话将排队等待；
4、CLI 工具（qoder-cli）调用时，每秒最多触发 2 次模型推理请求，连续高频触发将触发客户端级退避机制。
二、Credits 消耗规则详解
Credits 是 Qoder 平台计量 AI 能力调用的唯一单位，不等同于传统意义上的“API 调用次数”，而是按计算资源占用动态计费。其消耗与以下因素强相关：
1、输入上下文 token 数量：超过 8,192 tokens 将触发分块处理并叠加计费；
2、输出生成长度：每生成 1,000 tokens 约消耗 3–5 Credits；
3、是否启用 MCP 协议工具：调用外部服务（如 GitHub API、Jira 连接器）将额外扣除 10 Credits / 次；
4、使用高阶模型（如 qoder-pro-2026）比基础模型（qoder-lite）多消耗 40% Credits。
三、CLI 命令级速率控制策略
qoder-cli 工具内置客户端限流逻辑，用于防止突发请求冲击服务端，保障稳定性。该策略独立于 Credits 配额，仅作用于命令执行节奏：
1、qoder agent run 命令在单次执行中最多发起 12 次子请求（含规划、检索、编辑、验证等阶段）；
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、连续执行相同命令时，强制插入 最小 800ms 间隔，不可绕过；
3、若检测到终端环境无响应或 SIGINT 中断，未完成的 Credits 扣减将回滚，但已提交的模型请求不退还；
4、使用 --no-throttle 参数无效，该标志已被移除，CLI 不支持禁用节流。
四、开发者自控频方案
当自动化脚本需高频集成 Qoder 能力时，推荐采用以下三种本地协调方式规避服务端限流：
1、在脚本中引入随机抖动延迟，范围设为 300–1200ms，避免请求周期对齐；
2、对批量任务实施分片处理，单批次不超过 5 个文件变更 或 200 行代码生成；
3、启用本地缓存开关：qoder config set cache.enabled true，对重复提示词命中本地 LRU 缓存，不消耗 Credits；
4、使用 qoder repo index --force 预构建索引，减少后续会话中实时检索开销。
五、超限响应识别与处理
当请求因频率或配额问题被拦截时，Qoder 服务端返回标准 HTTP 状态码及结构化错误体，开发者应主动捕获并解析：
1、响应状态码为 429 Too Many Requests 时，Header 中包含 Retry-After: 37 字段，表示需等待秒数；
2、返回 JSON 错误体中出现 "code": "CREDITS_EXHAUSTED"，表示当日 Credits 归零，需充值或等待次日重置；
3、CLI 输出含 "throttled by client-side rate limiter" 提示，表明触发本地节流，无需重试；
4、Agent 模式中断日志出现 "context window overflow"，需缩减 --max-context 参数值。
