场景 · JSON 输出

要 JSON 就给约束:四种手段叠加才稳

只写「请输出 JSON」,成功率大概八成。叠加提示词示例、格式参数和校验修复,才能到接近 100%。

四种手段

  1. 给示例:在提示词里放一个完整的输入输出示例,比描述更有效;
  2. 用格式参数:支持 response_format 的模型直接限定 JSON 模式;
  3. 校验:解析后用 schema 校验类型与必填字段;
  4. 修复:校验失败时把错误信息回传给模型,只要求修正,不重新生成全部内容。

请求示例

Pythonpython
resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=msgs,
    response_format={"type": "json_object"},
)
data = json.loads(resp.choices[0].message.content)
⚠️ json_object 只保证「是 JSON」,不保证字段符合你的 schema。 json_schema 严格模式兼容性不一,先小样本试。

常见破坏方式

现象处理
包了 ```json 代码块解析前剥离围栏
JSON 后面多一段解释提示词要求「不要任何额外文字」,或取第一个完整 JSON 片段
字段名变中文schema 中明确键名,并在示例里体现
该是数字给了字符串校验时做类型转换,或在提示词里强调类型

常见问题

response_format 报错不支持怎么办?

该模型或渠道不支持该参数,去掉参数改用提示词约束 + 输出校验 + 失败重试。

怎么保证字段一定存在?

在提示词中给出完整示例,并在代码侧做 schema 校验;缺失字段要么修复重试,要么走默认值兜底。