在网页上跟AI聊天确实很方便，但要把AI能力真正融入你自己的产品、工作流、自动化脚本中，你需要的是API。
API是应用程序之间通信的桥梁，通过API，你的代码可以直接向AI模型发送请求并获取回复，不需要手动打开网页复制粘贴。
想象这些场景：你的电商网站自动为每件商品生成描述文案；你的笔记应用自动总结用户输入的长文；你的客服系统自动分类和回复用户咨询------这些功能都可以通过AI API实现。
一、API基础概念
API就是一套约定好的对话方式。你按特定格式发送请求，对方按特定格式返回结果。用点餐打个比方：你拿到菜单（API文档），知道可以点什么、怎么点（请求格式），对服务员说"一份宫保鸡丁"（发送API请求），厨房做好菜端上来（返回API响应）。你不需要进厨房，不需要知道菜怎么做的------这就是API的价值：封装复杂细节，只暴露简单接口。
JSON格式入门： JSON是API通信中最常用的数据格式，就是键值对的组合。对象用{}包裹，数组用[]包裹，字符串用双引号。一个典型的AI API请求体看起来就像这样：指定模型、消息列表、temperature参数等。
二、开发环境准备
Python是调用AI API最常用的语言，推荐使用Python 3.9或更高版本。pip是Python的包管理器，用来安装第三方库。代码编辑器推荐VS Code（免费轻量）、Cursor（内置AI辅助）或PyCharm（功能最全）。
三、OpenAI API入门
获取API Key： 访问platform.openai.com注册账号，进入API Keys页面创建密钥。重要：永远不要把API Key提交到公开的代码仓库里。
第一个API调用： 安装pip install openai，初始化客户端，发送聊天请求，提取AI的回复。国内替代方案：DeepSeek兼容OpenAI格式，只需替换api_key、base_url和model即可。
请求参数详解： model指定使用的模型，messages是对话历史，temperature控制输出随机性（0最确定，0.7平衡，1.8最随机），max_tokens限制生成长度。事实回答用低temperature，创意写作用高temperature。
四、Anthropic Claude API
Claude是Anthropic公司的大模型，以安全性和长文本处理著称。安装pip install anthropic，System Prompt在Claude中是独立参数。国内同样可以通过DeepSeek的兼容接口调用。
五、多轮对话管理
单轮对话简单，但真正有用的应用都需要"记住上下文"。思路很简单：把之前的对话都存下来，每次请求一起发给AI。关键点： 对话历史严格按照user-assistant-user-assistant交替，每次请求都要把完整历史发过去。
上下文窗口超限处理： 每个模型都有上下文窗口限制。处理策略包括只保留最近N条消息、用AI总结历史对话、或使用滑动窗口平衡。
六、流式输出
流式模式下，AI生成一个token就发一个，用户体验更好。技术上使用SSE协议。OpenAI和Claude都支持流式输出。只要不是必须等完整结果的场景，优先使用流式输出。
七、API费用计算与优化
AI API按Token计费。Token： 英文约0.75个单词，中文约1-2个汉字。计费方式=Prompt tokens + Completion tokens。优化技巧： 简单任务用便宜模型、限制max_tokens、裁剪上下文、简洁提示、相同问题缓存结果。
八、错误处理与重试机制
网络请求总会出错，需要处理各种异常情况。常见错误类型包括认证失败（401）、额度不足（402）、请求超限（429）、服务器错误（5xx）。指数退避重试： 第一次失败等1秒，第二次等2秒，第三次等4秒...可以用tenacity库简化重试逻辑。
九、实战项目：命令行AI聊天工具
将前面所有知识整合成一个完整的命令行聊天工具，包含：配置文件管理、多轮对话、流式输出、对话历史裁剪、费用统计、保存对话、切换模型、调整temperature等功能。