公告AI接口网提供各类可接入的人工智能接口
AI接口网AI 接口选型与接入工程手册
首页/接入实战/结构化输出:让模型稳定吐出可入库的 JSON

结构化输出:让模型稳定吐出可入库的 JSON

2026-11-22约 8 分钟读完结构化输出JSON抽取

抽取类任务(发票信息、简历字段、工单分类)的价值全在「能不能直接入库」。而模型输出 JSON 的稳定性,取决于你用了哪一层约束。

三层约束,从弱到强

层级手段稳定性代价
靠提示system 里写「只返回 JSON,不要解释」中,长输出时容易破功零成本
格式模式response_format={"type":"json_object"}较高,但字段结构不保证需 prompt 含 json 字样
Schema 约束json_schema + strict高,字段与类型受约束部分厂商不支持;schema 有子集限制
json
{
  "model": "gpt-5-mini",
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "invoice",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "invoice_no": {"type": "string"},
          "amount": {"type": "number"},
          "date": {"type": "string"},
          "items": {"type": "array", "items": {"type": "object",
            "properties": {"name": {"type": "string"}, "price": {"type": "number"}},
            "required": ["name", "price"], "additionalProperties": false}}
        },
        "required": ["invoice_no", "amount", "date", "items"],
        "additionalProperties": false
      }
    }
  }
}
strict 的约束
strict 模式通常要求:所有字段都在 required 里、每层都写 additionalProperties: false、不支持部分 JSON Schema 关键字(如 patternProperties)。schema 不合规时接口会直接 400,报错信息往往不直观。

不支持 schema 的厂商怎么办

三个兜底手段,按顺序用:

  1. 给一个完整示例:在 prompt 里放一段真实的输出样例,比抽象描述有效得多。
  2. 强制以 { 开头:用 prefix 或 assistant 预填(部分厂商支持),能显著降低「先来一段解释」的概率。
  3. 解析失败就修复:去掉 markdown 代码围栏、截取第一个 { 到最后一个 }、再解析;仍失败则带错误信息让模型重试一次(最多一次)。
python
def parse_json_loose(text):
    t = text.strip()
    if t.startswith('```'):
        t = re.sub(r'^```[a-zA-Z]*\n|```$', '', t).strip()
    i, j = t.find('{'), t.rfind('}')
    if i < 0 or j <= i:
        raise ValueError('no json object')
    return json.loads(t[i:j+1])

校验比约束更重要

schema 约束保证「形状对」,不保证「内容对」。金额可能是 0,日期可能是 2099 年,枚举值可能在集合外。入库前必须有业务校验:

  • 数值范围检查(金额 > 0 且 < 阈值)
  • 日期合理性(不在未来、不早于某个基准)
  • 枚举白名单(分类字段只能取预设值)
  • 交叉校验(明细合计 ≈ 总金额,允许小额误差)

流式下的结构化输出

开了 stream 之后 JSON 是逐字到达的,不能边收边 json.loads。做法是累积完整内容后再解析;如果要在前端渐进展示,用一个容错的增量解析器,或干脆流式只用于展示、结构化结果从最后一次完整响应里取。

说明
文中价格、配额、限额均为撰写时的公开口径,会随厂商调整变化;用于估算量级,不构成报价。具体以各厂商官方文档与合同为准。