跳转到主要内容
面向真实开发决策

AI 模型与 API 技术指南

聚焦 AI 模型、API 集成与开发工作流,把快速变化的价格、配额、能力和限制整理成可验证、可执行的技术决策。
  • 优先引用原始来源
  • 给出可复现步骤与失败边界
  • 易变事实标注核验日期
  • 470 篇文章
  • 6 种语言
  • 12 个主题
  • 最近更新 2026年10月6日

API 400 消息角色不受支持的排查示意
故障排查

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

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

20 分钟
Claude Code 的 API 密钥、网关和云平台配置示意
Claude Code

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

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

20 分钟
Gemini 3 Pro Image 批量生图与费用折扣主题图
API 价格与套餐

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

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

19 分钟
逐项核验训练用途、风控日志、应用状态、功能存储、第三方和自有日志,形成具体调用链的上线证据单。
API 接入指南

大模型 API 数据保留 vs 零数据保留:上线前怎么核验

标准有限保留是否可用,先看业务允许的用途、期限和保存位置;要求零数据保留时,再核对当前合同及具体组织、端点、模型、功能和日志。ZDR 还可能允许客户受控存储,不能直接等同于整条链路不落盘。

22 分钟
OpenAI API 连接错误排查示意,区分连接故障与已经返回的 HTTP 错误。
API 接入指南

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

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

20 分钟
OpenAI API quota exceeded 排查示意,围绕计费额度、项目归属与恢复请求组织检查。
API 接入指南

OpenAI API quota exceeded:先修计费额度,不要先重试

OpenAI API 提示 quota exceeded 或 insufficient_quota 时,先看 error.code:余额耗尽要补充额度,组织或项目支出超限要调整对应硬限制,获批用量用尽要申请提额。充值后仍失败,还要核对到账状态和请求所属组织、项目。

19 分钟