最新发布故障排查
修复 API 400 角色不受支持错误，不破坏系统提示词
system 角色被拒绝，先查最终请求走的是 Anthropic Messages、Chat Completions 还是 Responses。初始指令、对话中追加的指令和工具结果各有对应字段与位置；修好结构后，还要验证指令约束和完整任务。
20 分钟
面向真实开发决策
AI 模型与 API 技术指南
聚焦 AI 模型、API 集成与开发工作流，把快速变化的价格、配额、能力和限制整理成可验证、可执行的技术决策。
- 优先引用原始来源
- 给出可复现步骤与失败边界
- 易变事实标注核验日期
- 470 篇文章
- 6 种语言
- 12 个主题
- 最近更新 2026年10月7日
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 Code
Claude Code 报 top_p deprecated？别先换渠道，先按 Opus 4.7 的新请求规则排
top_p deprecated 不表示 Opus 模型已经退役。先找到最终请求中的旧采样字段：原生 Messages 用 top_p，Bedrock Converse 用 inferenceConfig.topP；省略正确位置的参数后，再验证同一任务是否恢复。
18 分钟
故障排查
Nano Banana Pro 503 模型过载：Deadline expired 怎么处理？
503 UNAVAILABLE 和 Deadline expired 可以同时出现。先确认是谁返回了错误，再在原接口上有限重试；达到次数或等待预算就停止并排队，只有拿到满足原要求的可用图片才算恢复。
20 分钟
API 接入指南
Gemini 3.5 Transcribe API 指南：预录转写、实时字幕与验证方法
已有录音用 gemini-3.5-transcribe，实时音频用 gemini-3.5-transcribe-live。预录的词表与说话人、逐词时间戳不能同时开启；实时字幕要分别处理临时和最终结果，并在音频结束后限时收尾。
17 分钟
API 价格与套餐
Gemini 3 Pro Image Batch API 五折：批量生图费用与 Python 实现
官方 Batch 把 Gemini 3 Pro Image 相应费率降为标准的一半，适合提前准备的图片任务。1K/2K 图片输出标价为 0.067 美元，但预算还需计入输入、思考与重试；提交后保存任务名，按请求键回收图片。
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 接入指南
LLM Agent API 花费熔断开关：在供应商调用前截住失控账单
在每次付费调用前，将已结算费用、在途预留和本次费用上界一起检查；额度不足立即停，账单未知继续占用额度。附不连接供应商的可运行预算闸门示例。
25 分钟
AI 图像生成
Nano Banana 2 503 模型过载：有界重试、暂停与出图验收
Nano Banana 2 返回 503 时，先确认接口和 HTTP 状态，再在次数与总耗时预算内退避重试；预算耗尽就暂停或排队，收到图片数据并完成解码才算出图成功。
16 分钟
API 接入指南
Nano Banana Pro API 怎么调用：JSON 请求、YAML 配置与 PDF 转图
官方 Pro 模型是 gemini-3-pro-image。新接入可用 Interactions API；应用 JSON/YAML 要先校验和转换，响应要遍历图片内容，PDF 则先提取事实再交给 Pro 生图。
20 分钟
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 接入指南
Realtime API 与转录管道成本怎么比：按同一任务算完整预算
只交付文字时，先算转写和必要的后处理；需要语音回应时，再比较 Realtime、GPTLive 与 STT→LLM→TTS 的完整费用。通话分钟、双方音频分钟和会话活跃秒数不能混用，便宜与否要落到完成同一任务的总成本上。
22 分钟
API 接入指南
AI Agent 工具调用死循环怎么停：重复检测、错误分类与熔断
先阻止下一次不安全工具调用，再用执行上限、真实进展、操作台账和不可自行重开的终态收口；响应丢失时先核对业务结果，再决定恢复。
24 分钟
ChatGPT 与 OpenAI
ChatGPT Cyber Abuse 封号：申诉写什么、聊天记录导出和 Pro 退款
Cyber Abuse 邮件先分清是警告还是停用：警告时账号仍可用，先导出数据；停用后只申诉一次，写清授权范围和当时任务，登不上走 Privacy Portal，退款按扣费渠道查。
25 分钟
Claude Code
Claude Code MCP 上下文爆掉：排查占用、工具搜索与输出压缩
Claude Code 接入 MCP 后上下文吃紧，先查占用是在调用前、返回后还是长会话中增长。工具搜索缓解定义加载，大结果需要源头筛选和按需读取；整理之后还要确认同一任务的证据与访问能力仍在。
19 分钟
Claude Code
Claude Code Mods 怎么用：安装前先审查，再写第一个 mod
Claude Code Mods 是插件里的 JS/TS 函数，2.1.287 起默认开启，能画窗格、改写工具调用，还能替你批准权限确认；装前先跑 validate、翻源码。
27 分钟
模型对比
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 分钟
API 接入指南
GPT-6.1 Sol 怎么用：价格变化、迁移改动与可用入口
GPT-6.1 Sol 标价同 GPT-6 Sol，仅缓存输入减半至 $0.10；推理强度改 low，工具调用改走 Responses。国内可经老张API调用，缓存命中按全价计费。
26 分钟