把 API 文档交给编程 AI：一键复制之后还要检查什么

用编程 AI 接接口，最容易出错的是给它一份不完整或过期的说明。先把接口资料整理好，再让它落到当前项目。

文档先选到具体模型

API 文档包含模型与通用接口方向，可以将接口说明通过“一键复制给 AI”交给 Cursor、Claude Code、Cline 等工具；后续也有可下载的技能文件供编程 AI 读取。

模型名、协议、输入字段和返回方式一起提供。不要只给一个平台名称，让 AI 自己猜参数。

告诉 AI 放到哪个项目

说明项目使用的语言、现有请求封装、希望新增的功能，以及允许修改的文件。密钥用项目的安全配置方式读取，不直接粘进源文件或公开记录。

示例任务：在既有服务中加入一个文本调用，先返回普通结果，再补错误处理。用一个最小请求验证后，再扩展功能。

第一次只做一个可验证请求

检查请求地址、协议、模型标识、超时与错误处理。文本、图片、视频和音频可能有不同返回流程，不应把全部类型套成一种同步调用。

先拿到可读取的实际结果，再扩展到批量、流式或异步任务。

让 AI 解释失败在哪里

保留状态码、任务标识与不含密钥的错误摘要。检查是参数、权限、任务状态还是网络问题，修改对应环节。复制文档减少搬运工作，不能代替真实调用与结果验收。