A
01 · 介绍
什么是 API
API（应用程序编程接口）是服务为程序开放的一扇门。人通过网站使用服务，程序则通过网站背后的 API 使用服务。
对于 AI 模型来说，原理很简单：你发送一个请求，里面写着我的指令和我的文本是这些，服务运行模型，然后以数据的形式把答案返回给你。每一个聊天应用、每一个工作流工具和每一个智能体，底层都在使用这样的 API。
你会遇到的四个词：
- Endpoint：你发送请求的地址，例如
/v1/messages。 - API key：一串很长的密钥，用来识别并计费你的账户。
- Request / response：你发送的请求和返回的响应，通常使用 JSON 格式。
- Rate limit：每分钟你可以调用的次数上限。
02 · 适合什么场景
何时需要 API
- 一次性提问用聊天应用就够了。当同一任务需要多次运行或按定时执行时，请使用 API。
- 你希望把模型连接到自己的数据或产品上。
- 你需要程序可以读取的结构化答案（JSON），而不是散文式的文字。
- Zapier、Make 和 n8n 等工作流工具会替你调用 API，你只需要提供密钥。
03 · 配置
你的第一次调用
- 在某个服务商处创建账户，并充入少量额度。
- 创建一个 API key。复制一次后保存到密码管理器中；它只会显示一次。
- 发送一个请求。在任意电脑上使用
curl：
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-5-5","max_tokens":200,"messages":[{"role":"user","content":"Say hello in one line."}]}'
- 阅读响应：文本位于
content中，而usage会告诉你消耗了多少 token。
在工作流工具中，同样的操作是一个表单：粘贴一次密钥，选择模型，填写指令即可。
04 · 使用说明
日常使用
- 把不会变化的指令放在 system 消息中，把会变化的内容放在 user 消息中。
- 当程序需要读取回答时，请求固定结构的 JSON；两大主流模型服务商都支持你自定义的 schema。
- 设置
max_tokens，避免失控的回答带来高昂费用。 - 把密钥放在代码和聊天之外：使用环境变量或工具自带的密钥存储。
- 记录每次调用的 token 用量；这是了解工作流成本的唯一方法。
05 · 注意事项
常见陷阱
- 泄露的密钥就等于金钱损失。 任何拿到它的人都可以用你的账户计费。如果它曾出现在聊天、截图或代码仓库中，请立即轮换。
- 速率限制会返回错误（HTTP 429）。请等待后重试，而不是持续高频请求。
- 错误难免发生：超时、服务器过载。请加入一次带暂停的重试，并准备备用方案。
- 模型会不断更新，旧名称也会退役。请固定使用某个模型名称，并关注弃用通知。
06 · 资源
接下来去哪里
每个服务商的快速入门只需十分钟。先完成一个，然后把同样的调用接入你的工作流工具。
我的笔记
登录后可以在这本手册上记私人笔记。登录