JSON

JSON 是 JavaScript Object Notation 的缩写，一种以纯文本表示结构化数据的格式，由键值对与数组构成。它易于机器解析、也基本可读，因此成为 Web API 事实上的通用数据格式——调用模型 API 时，你发出的请求体和收到的响应体通常都是 JSON。

一次模型调用里的 JSON

请求体大致是这样一个结构：模型名、一组消息、若干参数。响应体则包含生成内容、结束原因与用量统计。两边都是 JSON，所以任何语言只要能解析 JSON 就能调用。

发送 JSON 时要在请求头声明 Content-Type: application/json，否则服务端可能按其它格式解析并报参数错误。

常见误解

• 模型「返回 JSON」和「接口用 JSON 传输」是两回事。 接口层面的响应体一定是 JSON；但模型生成的那段文本内容是否是合法 JSON，取决于你有没有启用结构化输出。
• 在提示词里写「只返回 JSON」不等于保证。 那只是请求，不是约束；解析端必须有失败兜底。
• JSON 没有注释也不允许尾逗号。 手写请求体时这两点最容易出错。

本站哪里会遇到

三篇官方 API 教程的最小示例都会展示一次完整的 JSON 请求与响应；模型输出格式怎么真正约束住，见结构化输出。