JSON 模式支持说明

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

什么是 JSON 模式

JSON 模式通过在请求中指定 response_format={"type":"json_object"}，要求模型以 JSON 格式返回结果。它不是对所有模型和通道都生效的全局开关。

重要提醒：当前模型广场展示模型类型、输入/输出模态、上下文、价格和通道信息，但没有单独的“JSON 模式支持”字段。因此不要把服务商列表、模型标签或文本模型类型直接当作 JSON 模式支持承诺；发起业务请求前仍需用实际模型 ID 验证返回结果。

如何使用 JSON 模式

基本使用方法

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

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

根据模型广场选择和验证

模型广场当前可见的文本模型包括 glm-5.1、deepseek-v4-flash、claude-haiku-4-5-20251001、gpt-5.4-mini 和 claude-sonnet-5 等；模型、通道、价格和能力会随配置变化。使用 JSON 模式时：

1. 在模型广场筛选文本生成模型，并复制当前页面展示的真实 model ID。
2. 使用该 model ID 发送 response_format: {"type":"json_object"} 请求。
3. 对响应执行 JSON 解析和业务 Schema 校验；不要只根据模型名称、标签或请求成功判断内容一定符合业务结构。
4. 如果当前模型或通道不支持该参数，按错误响应处理，或切换到模型广场中另一个文本模型后重新验证。

模型广场目前没有固定的 JSON 模式支持清单，也不应在客户端写死某个服务商或模型的永久支持结论。