AIGuide中文教程 · 独立阅读版
模型 API 入门：看懂请求、响应与校验
用一条通知看懂调用链，再分清服务响应、业务数据与失败处理。
进入互动版，练习并保存成果本篇目录
开始前准备 · 设备、账号与费用
了解基本 JSON。本课使用本站教学示例，不需要密钥；真实接入时再准备服务端、厂商账号、模型权限与调用预算。
1. 先看一遍调用链
沿着图看：通知从网页发出，服务端调用模型，再把检查后的结果交回网页。
- 你的网页
收集通知，显示结果
- 你的服务端
保存密钥，检查输入和输出
- 模型 API
处理输入，返回服务响应
返回方向：模型 API → 服务端 → 网页。
密钥与费用放在哪里理解？
普通服务端 API Key 由服务端环境变量读取，不写进网页 JavaScript、公开仓库或截图。厂商专门提供的临时凭据按其官方文档使用。
对话应用订阅与 API 调用分别核对权益和计费，不能默认互通。
2. 对照一份请求和响应
下面只展示“你的网页 ↔ 你的服务端”的业务约定。模型厂商的请求与原始响应另有格式。
{
"notice": "小林周五前整理报名表，活动地点未定。"
}{
"tasks": [{ "title": "整理报名表", "owner": "小林", "due": "周五前" }],
"questions": ["活动地点"]
}真正调用厂商时，要确认哪四项？
这些 JSON 只用于看懂字段；本站没有提供对应业务接口，它们也不是厂商原始响应或实测记录。不要把某家厂商的端点与另一家的字段直接拼在一起。
- 地址与端点：从所选厂商官方文档确认。
- 认证：按文档设置请求头；密钥从服务端读取。
- 模型 ID：使用当前账号有权限的准确标识。
- 输入与输出：按该端点组织 messages 或 input，并按文档提取返回内容。
3. 收到结果，还要检查两层
先看接口有没有成功，再看业务数据能不能用；HTTP 200 不能代替内容核对。
- 服务响应
状态、错误、完成状态 按文档提取返回内容
- 业务内容
JSON、必填字段、类型 再对照原文核实人名和时间
4. 遇到错误，先选下一步
先看错误类型，再决定是否重试。以下是常见处理方向，具体原因以厂商错误信息为准。
开始真实接入前
- 设置输入长度、输出预算、超时和有限重试。
- 只保留脱敏错误与必要的请求标识。
- 记录实际调用日期、端点、模型与结果，不能把本课示例当作调用成功。
401：认证失败
核对服务地址、认证方式和密钥配置；修正配置前不反复重试。
403：没有权限
核对账号、模型和组织权限，以及服务给出的访问限制说明。
429：限流或额度限制
先分清请求过快还是额度不足；按文档和 Retry-After（若提供）处理，设置重试上限。
超时：不知道是否完成
记录为“结果未确认”；先核对已有结果或任务状态，避免重复写入、重复发送。
请求成功，但内容不合格
输出截断、JSON 错误或事实不符，都先停止业务写入，修正后再检查。
练习与核对
- 指出网页、服务端、模型 API 各自负责什么
- 区分教学业务对象与厂商原始响应
- 为认证失败、超时和内容错误选出处理方式
按实际操作自查，完成标记与成果草稿请在互动版保存。
打开练习与核对带走这一点
服务返回成功后，还要检查业务结构，并对照原文核对事实。
资料与核对记录
本站通用练习这是一篇本站编写的通用方法与练习，官方资料用于解释产品关系和使用条件；日期反映所引用来源的最近核对。
练习提示、预期结果与检查表不代表官方承诺，也不代表在所列软件中逐一实操通过。
查看来源与日期
- GLM Function Calling
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
工具定义、tool_calls、工具执行及结果回传
- DeepSeek API 快速开始
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
模型别名、地址、思考模式请求参数
- Qwen 官方文档
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
权重、推理框架与部署入口；不用于判断最新版本
- MiniMax 模型概览
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
文本、语音等服务分类及当前文档入口
- OpenAI 官方 Node SDK
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
Responses 请求、环境变量及 output_text
- Claude Python SDK 使用示例
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
Messages 调用与 content 读取
- Claude SDK：Message 响应类型
已核对资料 · 获取：2026年9月14日 · 来源更新：未披露
content 内容块及 stop_reason 字段
- Gemini API 快速开始
已核对资料 · 获取：2026年9月14日 · 来源更新：2026年9月4日
Interactions API 的图文 input 和 output_text