最佳实践

如何更稳定地使用 1A1API

这些不是必须步骤，但能明显减少超时、密钥泄露、费用不清、上下文过长和售后排查成本。

返回文档首页打开 1A1API 控制台看常见排错

推荐做法

推荐最佳实践

✓ 长任务优先开启 stream: true，避免长时间无输出导致超时。

✓ 大项目让 Codex / Claude Code 分阶段处理，不要一次塞完整仓库和大量日志。

✓ 一个项目创建一个独立 API Key，方便统计、限额、禁用和排查。

✓ API Key 只放服务端或本地私有配置，不放前端、公开仓库、截图或群聊。

✓ 不要无限并发压测。遇到 429 先降并发、加重试、换模型或稍后再试。

✓ 高峰期模型繁忙时，优先换 mini、备用模型或拆小任务。

✓ 重要任务先小范围测试，确认日志和费用正常后再长时间跑。

✓ 出错先看调用日志，再联系客服；日志比客户端弹窗更有排查价值。

安全建议：出现异常请求、Key 泄露或不认识的调用日志时，先在控制台禁用对应 API Key，再带日志截图联系客服。