最新发布故障排查
修复 API 400 角色不受支持错误，不破坏系统提示词
system 角色被拒绝，先查最终请求走的是 Anthropic Messages、Chat Completions 还是 Responses。初始指令、对话中追加的指令和工具结果各有对应字段与位置；修好结构后，还要验证指令约束和完整任务。
20 分钟
面向真实开发决策
AI 模型与 API 技术指南
聚焦 AI 模型、API 集成与开发工作流，把快速变化的价格、配额、能力和限制整理成可验证、可执行的技术决策。
- 优先引用原始来源
- 给出可复现步骤与失败边界
- 易变事实标注核验日期
- 470 篇文章
- 6 种语言
- 12 个主题
- 最近更新 2026年10月7日
API 接入指南
Chat Completions 迁移 Responses API：函数调用完整循环与验收
迁移时保留业务函数，重写它外面的协议循环：遍历 output、校验并执行调用、用原 call_id 回传结果、继续请求。只有工具执行与最终回答都完成，才算迁移成功。
18 分钟
开发工具与智能体
ChatGPT Agent 本地文件解决办法：Work、Codex 和 Claude Code 权限区别
读一份文档，用上传或 Library；处理当前文件夹和未提交代码，用对应主机上的 Work、Codex 或 Claude Code。关键是确认执行位置与文件版本，再分别设置读写、命令、网络和应用权限。
29 分钟
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 --dangerously-skip-permissions：跳过确认、设置与安全替代
--dangerously-skip-permissions 和 --permission-mode bypassPermissions 启用同一种模式：跳过多数工具确认，仍保留部分强制询问与阻断。只想减少日常编辑打断，可先选 acceptEdits；长期自动化还需要真实的文件和网络隔离。
24 分钟
Claude Code
Claude Code 连接 OpenRouter 和 DeepSeek：路线选择、配置与首错排查
通过 OpenRouter 用 DeepSeek，配置 OpenRouter 密钥与 deepseek/deepseek-v4.1-flash；直接请求 DeepSeek，使用其 Anthropic 端点与 deepseek-flash。主模型和辅助角色要分别设置，成功回复后还需核对实际模型与用量。
20 分钟
Claude Code
Claude Code Statusline 配置：可用脚本、字段与排障
个人初版可用 /statusline 生成；想控制字段和缺值处理，就用手动脚本。先用模拟 JSON 跑出一行输出，再配置作用域，定位空白、旧值及 Windows 路径问题。
21 分钟
Claude Code
Claude Code 报 top_p deprecated？别先换渠道，先按 Opus 4.7 的新请求规则排
top_p deprecated 不表示 Opus 模型已经退役。先找到最终请求中的旧采样字段：原生 Messages 用 top_p，Bedrock Converse 用 inferenceConfig.topP；省略正确位置的参数后，再验证同一任务是否恢复。
18 分钟
Claude 与 Anthropic
Claude MCP 内部工具 API 集成：直连工具、MCP 连接器还是自建服务器？
已有应用负责用户登录、权限和内部 API 执行时，先用 Claude API 工具调用；多种客户端需要复用工具时，再做 MCP 接口。接入是否成功，要同时看调用 ID、服务端身份、业务结果和审计记录。
26 分钟
开发工具与智能体
Codex CLI Token 成本：长任务前先估算每日 API 支出
Codex CLI 每日 API 费用要按实际模型和互斥的 Token 类别计算。先分清订阅与 API 计费，再用场景演算、用量核对和剩余预算决定长任务能否继续。
26 分钟
故障排查
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 分钟
AI 图像生成
Imagen 4 停用后怎么迁移？Nano Banana 2.1 与 Pro 选择指南
截至 2026 年 10 月 7 日，Developer API 的 Imagen 4 替代建议已变为 Nano Banana 2.1。迁移时还要重做配置和图片解析，用交付要求决定是否采用 Pro，并准备仍受支持的备用路线。
23 分钟
API 接入指南
LLM Agent API 花费熔断开关：在供应商调用前截住失控账单
在每次付费调用前，将已结算费用、在途预留和本次费用上界一起检查；额度不足立即停，账单未知继续占用额度。附不连接供应商的可运行预算闸门示例。
25 分钟
开发工具与智能体
小团队多代理编程工作流：Worktree、任务分工与合并验收
先拆清任务，再让代理并行：每个实现者用独立目录，交付固定提交和检查记录；负责人把变更逐个合到候选版本，在合并后的整体上验证。角色分工与 Git 隔离不能代替运行权限控制。
25 分钟
AI 图像生成
Nano Banana 2.1 价格与入口：每张 $0.0336 起，NB2 10 月 29 日停用
Nano Banana 2.1 于 10 月 6 日正式发布，图片单价约为 Nano Banana 2 的一半，输入和思考 token 更贵；后者 10 月 29 日停用。
23 分钟
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 分钟
AI 图像生成
Nano Banana Pro Seed 参数怎么用？接口核对与图片一致性方案
想再次得到同一张图，先保存满意的原文件；想让角色换场景仍保持一致，使用批准的参考图和明确的保持条件。Nano Banana Pro 的 seed 要按具体接口核对，文档有字段也不代表每次输出完全相同。
18 分钟
故障排查
Nano Banana Pro 提示“Unsupported file URI type”？先把 Gemini 文件路径修对
遇到 Unsupported file URI type，先检查图片字段实际发出的值：它应是当前接口支持的单一引用，而不是本地路径、未展开表达式或数组。原生 Gemini 已支持符合条件的 HTTPS 图片地址，也可使用原始 base64 或上传返回 URI。
15 分钟