面向真实开发决策

AI 模型与 API 技术指南

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

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

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

最新发布API 接入指南

AI Agent 工具调用死循环怎么停：重复检测、错误分类与熔断

先阻止下一次不安全工具调用，再用执行上限、真实进展、操作台账和不可自行重开的终态收口；响应丢失时先核对业务结果，再决定恢复。

2026年10月6日24 分钟

故障排查

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

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

2026年10月6日20 分钟

Cyber Abuse 封号后的申诉、导出与退款：请求被改道时账号还在，收到警告先导出数据，收到停用邮件只申诉一次

ChatGPT 与 OpenAI

ChatGPT Cyber Abuse 封号：申诉写什么、聊天记录导出和 Pro 退款

Cyber Abuse 邮件先分清是警告还是停用：警告时账号仍可用，先导出数据；停用后只申诉一次，写清授权范围和当时任务，登不上走 Privacy Portal，退款按扣费渠道查。

2026年10月6日25 分钟

Claude Code

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

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

2026年10月6日20 分钟

Claude Code

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

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

2026年10月6日21 分钟

Claude Code

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

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

2026年10月6日20 分钟

Claude Code

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

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

2026年10月6日18 分钟

Sonnet 5.5 对比 Sonnet 5：每百万 token 单价同为 $2 / $10，medium 档每任务成本降 41%，max 档涨 51%

模型对比

Claude Sonnet 5.5 对比 Sonnet 5：分档成本与五项破坏性变更

Claude Sonnet 5.5 与 Sonnet 5 单价相同。按第三方分档测试，low 到 xhigh 每任务更省，max 档贵约五成；改模型 ID 前先查五项破坏性变更。

2026年10月6日25 分钟

无法认证不是封号、先查状态页的封面，右侧依次是 claude.ai 右下角的 Temporarily unable to authenticate 提示、status.claude.com 错误率升高公告和 Anthropic 请勿登出的公告原话

Claude 与 Anthropic

Claude unable to authenticate 无法认证：先查事故，再修本机或账号

Claude 提示无法认证不是封号：Temporarily unable to authenticate 有事故就别登出，Login expired 等本机报错才重新登录。

2026年10月6日29 分钟

Codex 令牌交换失败 403 按完整错误后缀定位：回调未到达、交换收到拒绝、地区或工作区限制分别采取不同动作

开发工具与智能体

Codex 令牌交换失败 403 怎么解决？按错误后缀定位登录拒绝

Codex 令牌交换 403 没有通用的一键修复：保留完整错误后缀，回调不通时选设备码或 SSH，地区与工作区拒绝时核对资格和权限，最后在原环境验证原认证方式。

2026年10月6日19 分钟

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

API 接入指南

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

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

2026年10月6日17 分钟

API 价格与套餐

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

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

2026年10月6日19 分钟

9 月 20 日版封面：Gemini 4、GPT-6 Astra、Fable 5.2 三个资料夹并排，标题为先核实信息，再比较能力

模型对比

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月6日18 分钟

GPT-6.1 Sol 调用路线与缓存计费示意：OpenAI 直连缓存输入 $0.10，老张API缓存命中按普通输入 $2 计费，工具调用走 Responses

API 接入指南

GPT-6.1 Sol 怎么用：价格变化、迁移改动与可用入口

GPT-6.1 Sol 标价同 GPT-6 Sol，仅缓存输入减半至 $0.10；推理强度改 low，工具调用改走 Responses。国内可经老张API调用，缓存命中按全价计费。

2026年10月6日26 分钟

API 接入指南

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

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

2026年10月6日25 分钟

Nano Banana 2.1 还没正式发布：截至 2026 年 10 月 6 日无模型 ID、无价格，对照已发布的 Nano Banana 2 每张 $0.067（1K）与 Nano Banana Pro 每张 $0.24（4K）

AI 图像生成

Nano Banana 2.1 现状与对比：Flow 短暂出现，Google 未官宣

截至 2026 年 10 月 6 日，Nano Banana 2.1 未官宣，没有 API 和价格，Flow 里短暂出现后被报告撤回；上线项目先用 Nano Banana 2。

2026年10月6日22 分钟

AI 图像生成

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

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

2026年10月6日16 分钟

AI 图像生成

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

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

2026年10月6日16 分钟

故障排查

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

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

2026年10月6日15 分钟

OpenAI API 连接错误排查示意，区分连接故障与已经返回的 HTTP 错误。

API 接入指南

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

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

2026年10月6日20 分钟