主题模式

JSON 模式支持说明 ​

本文档介绍如何使用 AI Ping 的 JSON 模式功能，让 AI 模型按照指定的 JSON 格式返回结果。

什么是 JSON 模式 ​

JSON 模式是一种让 AI 模型强制输出结构化数据的功能。通过在请求中指定 response_format={"type":"json_object"}，可以让模型以纯 JSON 格式返回结果，而不会包含额外的说明文字或格式问题。

重要提醒：JSON 模式的效果取决于具体的模型和供应商，有些模型可能对 JSON 模式的约束执行得更好。

如何使用 JSON 模式 ​

基本使用方法 ​

在 Chat Completions API 请求中添加 response_format 参数：

bash
curl -X POST https://aiping.cn/api/v1/chat/completions \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
  "model": "DeepSeek-V3.2",
  "messages": [
    {
      "role": "system",
      "content": "你是一个专业的 JSON 输出助手，请严格按照 JSON 格式回答。"
    },
    {
      "role": "user",
      "content": "列出 2 种颜色，返回格式：{\"colors\":[\"颜色1\",\"颜色2\"]}"
    }
  ],
  "response_format": {"type": "json_object"}
}'

固定供应商使用 ​

为确保获得最佳的 JSON 模式效果，可以指定特定的供应商：

bash
curl -X POST https://aiping.cn/api/v1/chat/completions \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
  "model": "DeepSeek-V3.2",
  "messages": [
    {
      "role": "user",
      "content": "请返回 {\"success\": true}"
    }
  ],
  "response_format": {"type": "json_object"},
  "extra_body": {
    "provider": {
      "only": ["硅基流动"]
    }
  }
}'

支持情况说明 ​

基于过去一段时间的测试结果，不同模型和供应商对 JSON 模式的支持程度如下：

推荐使用的供应商和模型 ​

以下供应商的模型能够严格返回合法的 JSON 格式（首字母排序）：

  • SophNet
  • UCloud
  • 阿里云百炼
  • 百度智能云
  • 百灵大模型
  • 硅基流动
  • 基石智算
  • 京东云
  • 金山云星流
  • 快手万擎
  • 模力方舟
  • 并行智算云
  • 七牛云
  • 讯飞星辰

部分支持的供应商和模型 ​

部分模型虽然可以请求成功，但返回的内容可能不是标准的 JSON 格式，需要额外的处理和验证。