什么是 API 和 JSON

什么是 API 和 JSON

在调用 AI 之前，需要先搞懂两个概念。别担心，比你想的简单得多。

API：程序之间的「菜单」

API（Application Programming Interface，应用程序接口） 听起来很高大上，但其实就是一个菜单。

想象你去餐厅吃饭：

• 你不需要知道厨房怎么做菜
• 你只需要看菜单，告诉服务员你要什么
• 服务员把你的需求传给厨房，厨房做好菜端给你

API 就是这个「菜单 + 服务员」的角色：

• 你的程序（你）通过 API（菜单）告诉 AI 服务（厨房）你要什么
• AI 服务处理好后，把结果通过 API 返回给你

每个 AI 服务都有自己的 API 文档，告诉你「能点什么菜」以及「怎么点」。

API Key：你的「会员卡」

调用 AI 的 API 通常需要一个 API Key，就像餐厅的会员卡：

• 它告诉 AI 服务「我是谁」
• AI 服务根据它来计费
• 绝对不要泄露给任何人，就像不要泄露银行卡密码

JSON：程序交流的「标准格式」

当你的程序和 AI 服务对话时，它们用什么格式交流？答案是 JSON。

JSON 就是一种用花括号和键值对组织数据的格式：

{
  "name": "小明",
  "age": 25,
  "skills": ["Python", "AI", "CLI"]
}

看起来像什么？就像一个快递单：

• 每个字段都有名字（键）和内容（值）
• 文字用引号包起来
• 列表用方括号
• 整体用花括号

一个 AI 请求长什么样

当你用 curl 调用 DeepSeek API 时，发送的 JSON 大致是这样的：

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "user", "content": "你好，介绍一下你自己"}
  ]
}

翻译成人话就是：

• model：我要用哪个模型
• messages：我要说的话

AI 返回的也是 JSON：

{
  "choices": [
    {"message": {"content": "你好！我是 DeepSeek..."}}
  ]
}

小结

概念	类比	作用
API	餐厅菜单	定义你能请求什么
API Key	会员卡	身份识别和计费
JSON	快递单格式	程序之间交流数据的标准格式
curl	外卖员	帮你把请求送到 API，把结果带回来

搞懂了这三个概念，下一节课我们就能真正在终端里和 AI 对话了。