面向真实开发决策

AI 模型与 API 技术指南

聚焦 AI 模型、API 集成与开发工作流，把快速变化的价格、配额、能力和限制整理成可验证、可执行的技术决策。

优先引用原始来源
给出可复现步骤与失败边界
易变事实标注核验日期

470 篇文章
6 种语言
12 个主题
最近更新 2026年10月7日

修复 API 400 角色不受支持错误，不破坏系统提示词

system 角色被拒绝，先查最终请求走的是 Anthropic Messages、Chat Completions 还是 Responses。初始指令、对话中追加的指令和工具结果各有对应字段与位置；修好结构后，还要验证指令约束和完整任务。

2026年10月7日20 分钟

Claude Code

Claude Code API 配置：先选路由，再设置 Key、模型和网关

已有 Anthropic API Key，就设置 ANTHROPIC_API_KEY 并在交互模式批准使用；已有企业网关，就按其认证方式配置地址和凭据。settings 文件可能覆盖终端变量，模型与 VS Code、Desktop 入口还需分别设置。

2026年10月7日20 分钟

Claude Code

Claude Code 上下文、记忆、MCP 与 Context7：先修正确层级

长会话跑偏、跨会话丢规则和 Context7 查不到文档，需要修复不同环节。先确认窗口占用与规则加载，再按实际安装方式检查连接和认证。

2026年10月7日21 分钟

Claude Code

Claude Code --dangerously-skip-permissions：跳过确认、设置与安全替代

--dangerously-skip-permissions 和 --permission-mode bypassPermissions 启用同一种模式：跳过多数工具确认，仍保留部分强制询问与阻断。只想减少日常编辑打断，可先选 acceptEdits；长期自动化还需要真实的文件和网络隔离。

2026年10月7日24 分钟

Claude Code

Claude Code 连接 OpenRouter 和 DeepSeek：路线选择、配置与首错排查

通过 OpenRouter 用 DeepSeek，配置 OpenRouter 密钥与 deepseek/deepseek-v4.1-flash；直接请求 DeepSeek，使用其 Anthropic 端点与 deepseek-flash。主模型和辅助角色要分别设置，成功回复后还需核对实际模型与用量。

2026年10月7日20 分钟

Claude Code

Claude Code Statusline 配置：可用脚本、字段与排障

个人初版可用 /statusline 生成；想控制字段和缺值处理，就用手动脚本。先用模拟 JSON 跑出一行输出，再配置作用域，定位空白、旧值及 Windows 路径问题。

2026年10月7日21 分钟

Claude Code

Claude Code 报 top_p deprecated？别先换渠道，先按 Opus 4.7 的新请求规则排

top_p deprecated 不表示 Opus 模型已经退役。先找到最终请求中的旧采样字段：原生 Messages 用 top_p，Bedrock Converse 用 inferenceConfig.topP；省略正确位置的参数后，再验证同一任务是否恢复。

2026年10月7日18 分钟

故障排查

Nano Banana Pro 503 模型过载：Deadline expired 怎么处理？

503 UNAVAILABLE 和 Deadline expired 可以同时出现。先确认是谁返回了错误，再在原接口上有限重试；达到次数或等待预算就停止并排队，只有拿到满足原要求的可用图片才算恢复。

2026年10月7日20 分钟

Gemini 3.5 Transcribe 预录文件与实时字幕的接口选择和接入要点

API 接入指南

Gemini 3.5 Transcribe API 指南：预录转写、实时字幕与验证方法

已有录音用 gemini-3.5-transcribe，实时音频用 gemini-3.5-transcribe-live。预录的词表与说话人、逐词时间戳不能同时开启；实时字幕要分别处理临时和最终结果，并在音频结束后限时收尾。

2026年10月7日17 分钟

Gemini 3 Pro Image Batch 的五折图片输出费用与提前排期主题图。

API 价格与套餐

Gemini 3 Pro Image Batch API 五折：批量生图费用与 Python 实现

官方 Batch 把 Gemini 3 Pro Image 相应费率降为标准的一半，适合提前准备的图片任务。1K/2K 图片输出标价为 0.067 美元，但预算还需计入输入、思考与重试；提交后保存任务名，按请求键回收图片。

2026年10月7日19 分钟

GPT-6.1 Sol、Gemini 4 Argon、Fable 5.5 与 GPT-6.1 Astra 的当前可用状态示意。

模型对比

Fable 5.5、Gemini 4、GPT-6.1 对比：现在只有 Sol 能调用

截至 2026 年 10 月 6 日，只有 GPT-6.1 Sol 能调用，Astra 版已取消；Gemini 4 Argon 仅限 Fairwind，Fable 5.5 是传闻。

2026年10月7日18 分钟

AI 图像生成

Imagen 4 停用后怎么迁移？Nano Banana 2.1 与 Pro 选择指南

截至 2026 年 10 月 7 日，Developer API 的 Imagen 4 替代建议已变为 Nano Banana 2.1。迁移时还要重做配置和图片解析，用交付要求决定是否采用 Pro，并准备仍受支持的备用路线。

2026年10月7日23 分钟

API 接入指南

LLM Agent API 花费熔断开关：在供应商调用前截住失控账单

在每次付费调用前，将已结算费用、在途预留和本次费用上界一起检查；额度不足立即停，账单未知继续占用额度。附不连接供应商的可运行预算闸门示例。

2026年10月7日25 分钟

Nano Banana 2 遇到 503 后有限重试、延期与实际图片验收的主题图。

AI 图像生成

Nano Banana 2 503 模型过载：有界重试、暂停与出图验收

Nano Banana 2 返回 503 时，先确认接口和 HTTP 状态，再在次数与总耗时预算内退避重试；预算耗尽就暂停或排队，收到图片数据并完成解码才算出图成功。

2026年10月7日16 分钟

应用提示对象和 YAML 经校验转换为图片请求，PDF 先经过文档处理的流程示意

API 接入指南

Nano Banana Pro API 怎么调用：JSON 请求、YAML 配置与 PDF 转图

官方 Pro 模型是 gemini-3-pro-image。新接入可用 Interactions API；应用 JSON/YAML 要先校验和转换，响应要遍历图片内容，PDF 则先提取事实再交给 Pro 生图。

2026年10月7日20 分钟

Gemini Pro 重做、AI Mode Pro 和原生 API 三种入口的限制排查主题图。

AI 图像生成

Nano Banana Pro 提示 `RESTRICTED by System Instructions`？先查入口，不要先改 prompt

Gemini 中选了 Pro，不代表第一张图就由 Nano Banana Pro 生成。先检查“更多 → 使用 Pro 重做”、资格与额度；开发者则核对稳定模型和实际图片。原请求失败的原因要看反馈，不能只凭一个成功对照判断。

2026年10月7日16 分钟

原生 Gemini 的 HTTPS、内联字节和 Files 返回 URI 三种输入路线主题图。

故障排查

Nano Banana Pro 提示“Unsupported file URI type”？先把 Gemini 文件路径修对

遇到 Unsupported file URI type，先检查图片字段实际发出的值：它应是当前接口支持的单一引用，而不是本地路径、未展开表达式或数组。原生 Gemini 已支持符合条件的 HTTPS 图片地址，也可使用原始 base64 或上传返回 URI。

2026年10月7日15 分钟

从同一运行环境定位 DNS、TLS 和代理断点，并保留请求结果不确定性的主题图。

API 接入指南

OpenAI API 连接错误：先验证路由再修复 APIConnectionError

遇到 openai.APIConnectionError: Connection error，先在报错进程或容器里检查 DNS、TLS、代理和实际 API 地址，再按 Python、Node 的版本配置超时与客户端。用底层异常区分修复方向，用原业务请求确认恢复；没有 request ID 不代表请求未被处理。

2026年10月7日20 分钟