API 是“应用程序编程接口”,英文为 Application Programming Interface,是软件之间按约定使用功能或交换信息的方式。它不是某一种 AI 模型,也不只用于 AI。普通人使用地图、自动化工具或连接服务时,可能已经在间接使用 API。

一句话理解:程序之间有约定的交互方式

你在网页上点击按钮,是通过面向人的界面操作;程序调用 API,则按接口要求发送参数或调用功能,再处理返回结果。有的 API 在本地程序或浏览器里,有的通过网络访问远端服务,并非全部都要连接互联网。

可以把它类比为办事窗口:先说明要办什么,提交规定材料,再收到结果或补充材料的提示。但 API 不是人工窗口,它依赖明确的数据格式和程序规则,不会自动理解所有随意表达。

从一份周报看连接过程

设想一个教学流程:你在表单里填写虚构工作记录,自动化工具把文字交给某个模型服务生成周报草稿,再把草稿放回文档。表单、模型服务与文档程序可能通过各自的 API 连接。

普通用户不一定亲手写请求。平台上的“连接账号”“选择字段”“运行节点”,可能在背后完成这些步骤。知道 API 是什么,有助于你理解为什么需要授权、为什么某个字段必须填写,以及错误发生在哪一段。

这个例子只描述可能的架构,不表示所有产品都提供相同接口,也不意味着本网站正在代你调用任何模型。

看懂请求与响应

请求是程序提出的调用,响应是另一方返回的结果。对于常见网络接口,你可能遇到接口地址、操作方式、参数和身份凭证。接口文档会说明哪些字段必填、接受什么格式,以及失败时返回什么信息。

下面只是用于阅读的虚构数据,不是可执行接口,也不会发送请求。JSON 是一种常见的结构化数据表示格式,用名称和值组织信息。

数据示例 · 不执行请求
{
  "task": "整理周报草稿",
  "text": "已整理帮助文档,目录等待确认",
  "format": "三段文字"
}

返回内容可能包含生成的文本,也可能是“缺少必填参数”或“没有权限”。会填写聊天框,不等于能把完全相同的文字直接放进任何 API:不同接口有不同约定,必须按对应文档操作。

API 密钥为什么不能随便分享

有些服务用 API 密钥识别调用者和权限。密钥通常是一段敏感字符串,不是提示词,也不应该发到公开聊天、截图或网页代码里。能看到密钥的人可能在其权限范围内调用服务,甚至产生费用。

并非所有 API 都使用密钥,有些采用其他授权方式,公开接口也可能不需要身份认证。对普通用户更重要的是检查连接的服务是否可信、授权范围是否必要,以及是否能撤销访问。

本篇练习不要求申请密钥。以后如果确实需要接入,应按官方说明安全保存凭证,设置合适权限,并确认数据会发往哪个服务;不要把密钥粘给 AI 让它代你排错。

常见误区:买了聊天会员就能调用接口?

聊天产品与开发接口可能属于不同服务,权限和计费规则也可能不同。不能因为一个网页能聊天,就认为它的 API 自动可用或已包含在同一订阅中。应查看具体服务的说明,而不是套用别家产品的规则。

接口也不保证永远成功。参数错误、权限不足、频率限制或网络故障都可能导致失败。对于会创建文档、发送消息的请求,不要在不清楚执行结果时反复重试,以免重复操作。

“提供 AI API”通常意味着能以程序方式使用某种能力,不代表拿到了模型文件、训练数据或无限制权限。这些是不同层次的事情。

小练习:画出数据去向

不用注册任何服务,在纸上写“表单记录 → 周报草稿 → 文档”。标出每一步需要什么输入、交付什么结果,再问三个问题:哪一步会接触原始资料?哪一步需要授权?失败时应该提醒谁?

最后圈出不应该传递的信息,例如真实客户名单或账号凭证。能看懂这张数据流,你就能更有把握地使用现成连接功能;是否自己写代码,可以留到确实需要时再学。

参考来源

以下资料用于核对概念;正文与练习为本站重新组织的原创讲解,不是外文逐段翻译。

  1. MDN:Introduction to web APIs

    API 的基本作用、浏览器 API 与第三方 API 的区别。

    查阅:2026-09-19
  2. Red Hat:What is an API?

    接口作为软件交互约定,以及接口与应用集成的关系。

    查阅:2026-09-19
  3. Dify:Model Providers

    平台、模型提供商与凭证连接的具体例子;账号和计费说明不推广到其他服务。

    查阅:2026-09-19