先说结论：网页版像"堂食"，API 像"外卖窗口"。同一间厨房（模型），堂食只能你自己坐着吃；外卖可以把饭送到任意程序里、批量出餐、按份计价。这篇把 API 是什么、钱怎么算、怎么跑通第一个程序一次讲清。
目录
- 一个场景：为什么你迟早会用上 API
- API 到底是什么（一个类比就够）
- 老手不用网页版的 4 个理由
- token 是什么？为什么按它收费
- 同一个模型，为什么价格差好几倍
- 新手第一个程序（10 分钟）
- 新手最容易踩的 4 个误区
一、一个场景：为什么你迟早会用上 API
你可能遇到过这些情况：
- 想把 1000 条商品文案一次性改写，网页版只能一条条粘贴
- 写个小工具自动总结邮件，网页版没法接进去
- 团队 5 个人共用一个账号，谁用了多少说不清
- 想固定输出格式（比如必须返回 JSON），网页版经常"自由发挥"
这些需求的共同点：你要的不是"和 AI 聊天"，而是"让程序调用 AI"。这就是 API 存在的理由。
二、API 到底是什么（一个类比就够）
把大模型想象成一家餐厅：
| 方式 | 对应 | 你能做什么 | 限制 |
|---|---|---|---|
| 网页版 / APP | 堂食 | 你自己坐下来点菜吃 | 只能自己吃，不能打包给程序 |
| API | 外卖窗口 | 下单后饭菜送到任意地方 | 要自己写代码接单 |
两者的厨房（模型）完全一样，差别只在"谁来端菜"。
API 全称 Application Programming Interface，翻译过来就是"程序之间说话的接口"。你不需要理解技术细节，只要记住三件事：
- 你发一个请求（你要问什么）
- 服务方返回一个响应（模型说了什么）
- 每次请求都会计费（按量收钱）
三、老手不用网页版的 4 个理由
1. 可批量
网页版一次问一句；API 可以一次循环 1000 条。
python
for item in products: # 1000 条商品文案 resp = client.chat.completions.create(model=MODEL, messages=[...]) results.append(resp.choices[0].message.content)2. 可集成
能接进你自己的程序、网站、机器人、表格脚本里。网页版做不到。
3. 参数可控
python
resp = client.chat.completions.create( model=MODEL, messages=[...], temperature=0, # 要稳定输出就设 0 response_format={"type": "json_object"}, # 强制返回 JSON max_tokens=500, # 控制成本上限 )网页版里这些参数大多调不了。
4. 成本可核算
API 有账单、有明细、能按项目分摊。网页版只有"月费"，谁用了多少完全不知道。
四、token 是什么？为什么按它收费
模型不是按"字数"收费，而是按token（词元）。
粗略理解：2个汉字 ≈ 1 个 token，1 个英文单词 ≈ 0.3个 token（不同模型切分方式不同，只能粗估）。
一次请求的计费分两部分：
| 部分 | 是什么 | 例子 |
|---|---|---|
| 输入 token | 你发给模型的所有内容 | 系统提示词 + 历史对话 + 你这句话 |
| 输出 token | 模型生成的所有内容 | 回答正文 + 推理过程 |
这就是为什么很多人"自己估的账"和"平台账单"对不上：系统提示词和历史上下文也在计费，而它们看不见。
想算清楚，最简单的办法是：把每次响应里的usage存下来，月底和账单对一遍。
python
u = resp.usage print(u.prompt_tokens, u.completion_tokens, u.total_tokens)五、同一个模型，为什么价格差好几倍
经常看到"同一个模型，A 家 1 毛、B 家 5 分"，别急着选便宜的，先看这 4 件事：
1. 输入 / 输出单价不同
几乎所有平台都输出比输入贵（常见 2–4 倍）。你如果只是"读长文、答短句"，成本结构和"写长文"完全不同。
2. 上下文缓存
很多平台对重复出现的前缀（比如固定的系统提示词）按更低价格计费。所以把固定设定放最前面、逐字不改，能明显省钱。
3. 上下文长度
同样是"一句话提问"，如果你把 5 万字文档一起塞进去，输入 token 会暴涨。
4. 渠道是否"掺水"
这点要提醒：明显低于官方成本线的价格，来源通常是批量采购折扣 / 缓存优化 / 服务商让利，也可能是小模型冒充大模型或拼车号池。后者不仅不稳定，还有法律与账号风险——便宜的代价往往在你看不见的地方。
六、新手第一个程序（10 分钟）
第 1 步：装 SDK
bash
pip install openai为什么装 OpenAI 的库？因为国内绝大多数平台都做了OpenAI 兼容，同一套代码改个地址就能用。
第 2 步：拿一个 API Key
去任意一家国内大模型平台（阿里云百炼、DeepSeek、智谱等）注册，进控制台建一个API Key。
⚠️ Key 只显示一次，存好，不要发给别人、不要写进前端代码。
第 3 步：跑通
python
from openai import OpenAI client = OpenAI( api_key="你的 Key", base_url="https://<平台提供的地址>/v1", # 每家不同，看文档 ) resp = client.chat.completions.create( model="<平台文档里的模型名>", messages=[ {"role": "system", "content": "你是一个简洁的中文助手"}, {"role": "user", "content": "用三句话解释什么是 API"}, ], ) print(resp.choices[0].message.content) print("本次用量：", resp.usage)跑通后，你就完成了 90% 的人卡住的那一步。
第 4 步：先看余额和额度
很多人第一次跑就超额。注册后先去控制台确认：有没有免费额度、有效期多久、单次/单日上限多少。
七、新手最容易踩的 4 个误区
误区 1：以为 API 一定比订阅便宜不一定。用量极小的时候订阅更划算；只有当你需要批量、集成、可控时，API 才有优势。
误区 2：以为"无限额度"没有任何平台是真无限。要么有速率限制（每分钟请求数），要么有余额限制。看到"无限"要格外小心。
误区 3：把 Key 写进前端/公开仓库这是最常见的泄露方式。Key 只能放在你自己的服务器端。
误区 4：以为所有平台的同一个模型"完全一样"同名模型在不同渠道可能有不同版本、不同上下文长度、不同并发限制。选之前先小量试。
小结
- API = 给程序用的"外卖窗口"，厨房和网页版是同一个
- 计费按 token，输入 + 输出都算，系统提示词也算
- 价格差异要看：输入输出比、缓存、上下文长度、渠道是否掺水
- 入门只需三步：装 SDK → 拿 Key → 跑 20 行代码
- 四个坑：误判便宜、相信无限、前端泄露 Key、以为模型完全一样
如果这篇帮你跑通了第一个程序，收藏 + 关注一下，后面还会写：
- 《token 到底怎么算钱：拆开一次请求的成本》
- 《AI API 中转站是怎么工作的？7 类坑与自查表》
- 《给团队发 Key：怎么让 5 个人用同一个模型而互不干扰》
有问题评论区问，报错把状态码 + 报错原文贴出来，我帮你看。
