JSON Mode 与结构化输出：让 AI 返回可解析的数据

为什么需要结构化输出

AI 的自由文本输出难以程序化解析。结构化输出（JSON）让你可以直接将 AI 结果存入数据库、传给后端或用于前端展示，无需额外解析。

JSON Mode 实现

curl https://chinawhapi.com/v1/chat/completions \
  -H "Authorization: Bearer {key}" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.6-plus",
       "messages":[{"role":"user","content":"提取以下文本中的人名、公司和职位：{text}"}],
       "response_format":{"type":"json_object"},
       "messages":[{"role":"system","content":"请以 JSON 格式返回，包含 name、company、title 三个字段"}]}'

Prompt 设计技巧

在 system prompt 中明确指定 JSON 结构和字段类型；在 user prompt 中给出输出示例；要求模型在无法提取信息时返回 null 而不是编造。

常见错误

模型有时会返回 Markdown 包裹的 JSON（如 ```json...```），需要前端做 strip 处理。也可以在 Prompt 中明确要求 '不要使用 markdown 格式，只返回纯 JSON 文本'。