最新发布故障排查
修复 API 400 角色不受支持错误，不破坏系统提示词
system 角色被拒绝，先查最终请求走的是 Anthropic Messages、Chat Completions 还是 Responses。初始指令、对话中追加的指令和工具结果各有对应字段与位置；修好结构后，还要验证指令约束和完整任务。
20 分钟
面向真实开发决策
AI 模型与 API 技术指南
聚焦 AI 模型、API 集成与开发工作流，把快速变化的价格、配额、能力和限制整理成可验证、可执行的技术决策。
- 优先引用原始来源
- 给出可复现步骤与失败边界
- 易变事实标注核验日期
- 467 篇文章
- 6 种语言
- 12 个主题
- 最近更新 2026年10月6日
Claude Code
Claude Code API 配置：先选路由，再设置 Key、模型和网关
已有 Anthropic API Key，就设置 ANTHROPIC_API_KEY 并在交互模式批准使用；已有企业网关，就按其认证方式配置地址和凭据。settings 文件可能覆盖终端变量，模型与 VS Code、Desktop 入口还需分别设置。
20 分钟
Claude Code
Claude Code 上下文、记忆、MCP 与 Context7：先修正确层级
长会话跑偏、跨会话丢规则和 Context7 查不到文档，需要修复不同环节。先确认窗口占用与规则加载，再按实际安装方式检查连接和认证。
21 分钟
Claude Code
Claude Code 连接 OpenRouter 和 DeepSeek：路线选择、配置与首错排查
通过 OpenRouter 用 DeepSeek，配置 OpenRouter 密钥与 deepseek/deepseek-v4.1-flash；直接请求 DeepSeek，使用其 Anthropic 端点与 deepseek-flash。主模型和辅助角色要分别设置，成功回复后还需核对实际模型与用量。
20 分钟
模型对比
Claude Sonnet 5.5 对比 Sonnet 5：分档成本与五项破坏性变更
Claude Sonnet 5.5 与 Sonnet 5 单价相同。按第三方分档测试，low 到 xhigh 每任务更省，max 档贵约五成；改模型 ID 前先查五项破坏性变更。
25 分钟
Claude 与 Anthropic
Claude unable to authenticate 无法认证：先查事故，再修本机或账号
Claude 提示无法认证不是封号：Temporarily unable to authenticate 有事故就别登出，Login expired 等本机报错才重新登录。
29 分钟
开发工具与智能体
Codex 令牌交换失败 403 怎么解决？按错误后缀定位登录拒绝
Codex 令牌交换 403 没有通用的一键修复：保留完整错误后缀，回调不通时选设备码或 SSH，地区与工作区拒绝时核对资格和权限，最后在原环境验证原认证方式。
19 分钟
模型对比
Fable 5.5、Gemini 4、GPT-6.1 对比：现在只有 Sol 能调用
截至 2026 年 10 月 6 日，只有 GPT-6.1 Sol 能调用，Astra 版已取消；Gemini 4 Argon 仅限 Fairwind，Fable 5.5 是传闻。
18 分钟
API 接入指南
GPT-6.1 Sol 怎么用：价格变化、迁移改动与可用入口
GPT-6.1 Sol 标价同 GPT-6 Sol，仅缓存输入减半至 $0.10；推理强度改 low，工具调用改走 Responses。国内可经老张API调用，缓存命中按全价计费。
26 分钟
AI 图像生成
Nano Banana 2.1 现状与对比：Flow 短暂出现，Google 未官宣
截至 2026 年 10 月 6 日，Nano Banana 2.1 未官宣，没有 API 和价格，Flow 里短暂出现后被报告撤回；上线项目先用 Nano Banana 2。
22 分钟
AI 图像生成
Nano Banana 2 503 模型过载：有界重试、暂停与出图验收
Nano Banana 2 返回 503 时，先确认接口和 HTTP 状态，再在次数与总耗时预算内退避重试；预算耗尽就暂停或排队，收到图片数据并完成解码才算出图成功。
16 分钟
AI 图像生成
Nano Banana Pro 提示 `RESTRICTED by System Instructions`？先查入口，不要先改 prompt
Gemini 中选了 Pro，不代表第一张图就由 Nano Banana Pro 生成。先检查“更多 → 使用 Pro 重做”、资格与额度；开发者则核对稳定模型和实际图片。原请求失败的原因要看反馈，不能只凭一个成功对照判断。
16 分钟
故障排查
Nano Banana Pro 提示“Unsupported file URI type”？先把 Gemini 文件路径修对
遇到 Unsupported file URI type，先检查图片字段实际发出的值：它应是当前接口支持的单一引用，而不是本地路径、未展开表达式或数组。原生 Gemini 已支持符合条件的 HTTPS 图片地址，也可使用原始 base64 或上传返回 URI。
15 分钟
API 接入指南
OpenAI API 连接错误：先验证路由再修复 APIConnectionError
遇到 openai.APIConnectionError: Connection error，先在报错进程或容器里检查 DNS、TLS、代理和实际 API 地址，再按 Python、Node 的版本配置超时与客户端。用底层异常区分修复方向，用原业务请求确认恢复；没有 request ID 不代表请求未被处理。
20 分钟
API 接入指南
OpenAI API quota exceeded：先修计费额度，不要先重试
OpenAI API 提示 quota exceeded 或 insufficient_quota 时，先看 error.code：余额耗尽要补充额度，组织或项目支出超限要调整对应硬限制，获批用量用尽要申请提额。充值后仍失败，还要核对到账状态和请求所属组织、项目。
19 分钟
AI 视频生成
2026年最佳AI视频模型：完整对比指南（Sora 2、Veo 3.1、Runway等）
对比2026年最佳AI视频模型，包括Sora 2、Veo 3.1、Runway Gen-4.5、Kling 2.6和开源方案。提供经过验证的定价数据、每10秒视频的真实成本计算、基于场景的推荐方案以及API开发者指南。
40 分钟
Claude 与 Anthropic
Claude API 529 overloaded_error 怎么解决：重试设置与过载排查
529 overloaded_error 表示 Claude API 暂时过载。先确认实际响应和服务状态，让 SDK 或应用统一负责有限重试，再降低并发、验证完整结果；等待超出业务时限时停止本轮请求，持续失败则带请求 ID 寻求支持。
17 分钟
Claude 与 Anthropic
Claude API 500 内部服务器错误：有限重试与失败处理
500 api_error 表示 Claude API 内部发生意外错误。保存实际响应和请求 ID，对可安全重复的请求做有限退避；仍然失败时，结束当前调用、保留任务与失败记录，等待恢复或联系实际服务方。
15 分钟
Claude Code
Claude Code API Error 500 怎么办：恢复原会话，不重做已完成操作
Claude Code 报 API Error 500，先看出在任务中途、登录这一步，还是某个旧会话每轮都报。任务被打断时恢复原会话，核对已执行的文件和外部操作，只继续剩余步骤。
28 分钟
Claude Code
Claude Code Hooks、Skills 与斜杠命令：区别、选型和最小配置
需要复用审查步骤，先写 skill；需要每次工具调用前检查一个具体条件，配置 hook。斜杠命令是调用入口，自定义 commands 已并入 skills，技能既能由人调用，也能由 Claude 按需加载。
20 分钟
Claude Code
Claude Code Rate Limit Reached 怎么办：认出限额类型，原会话续跑
Claude Code 报 Rate limit reached，先看提示原文：会话或每周限额等重置，模型家族限额换模型，429 查凭据；订阅登录可在原会话自动续跑。
20 分钟
Claude Code
Claude Code 用量查看与 Token 审计：5 小时和每周额度、缓存与 MCP
Claude Code 剩余额度用 /usage 查看，/status 只看账号和计费路线。用量同时计入 5 小时和每周额度；掉得快时先按上下文、缓存和 MCP 归因，再排活。
25 分钟
Claude 与 Anthropic
Claude Rate Exceeded 错误：先确认限制归属再重试
Claude API Error: Rate limit reached 不一定是额度用完：先分清订阅窗口、1M 权限、API key 和网关，再按各自的 reset 处理。
13 分钟
API 接入指南
Gemini 3 Pro Image 免费吗：Gemini 免费版用不到，API 也不免费
Gemini 应用免费账号已用不到 Nano Banana Pro，只有订阅用户能用 Pro 重新生成；不订阅的唯一官方入口是美国英文版 AI 模式，API 出图没有免费层。
18 分钟