Генератор JSON Schema для структурированного вывода

Вставьте пример JSON, получите JSON Schema и скопируйте API-запрос, который заставит модель вернуть именно такую структуру. Всё работает в вашем браузере.

Имя схемы

Строгий режим

Каждое свойство становится required, additionalProperties равно false, а поля, отсутствующие в некоторых элементах, становятся nullable. Строгий структурированный вывод требует именно этого.

Ваш JSON обрабатывается в этом браузере и никогда не загружается.

Настройки запроса (модель, промпт)

Модель

Пример модели. Поддержка json_schema зависит от модели, поэтому проверьте страницу модели, прежде чем полагаться на неё.

Промпт

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "response",
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "age": {
      "type": "integer"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "joined": {
      "type": "string",
      "format": "date-time"
    },
    "skills": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        }
      },
      "required": [
        "city",
        "zip"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "name",
    "age",
    "email",
    "joined",
    "skills",
    "address"
  ],
  "additionalProperties": false
}

Запустите на HiAPI за три шага

01Создайте бесплатный аккаунт
Зарегистрируйтесь через почту, Google или GitHub. Это займёт около минуты.
Зарегистрироваться
02Создайте API-ключ
Создайте ключ в панели управления и используйте его вместо YOUR_API_KEY.
Получить API-ключ
03Сделайте первый вызов
Запустите сгенерированный код. Ваш запрос появится в журнале использования.

Как создать схему для структурированного вывода

01 Вставьте пример JSON

Используйте реальный пример нужного вам вывода с репрезентативными значениями. Включите несколько элементов массива, чтобы опциональные поля были обнаружены.
02 Проверьте схему

Проверьте типы и форматы и при необходимости переименуйте поля. Строгий режим делает каждое поле обязательным, чего и требует строгий структурированный вывод.
03 Скопируйте вызов API

Выберите cURL, Python или Node.js, добавьте ключ и запустите. Результат — JSON-строка в choices[0].message.content.

Частые вопросы о генераторе JSON Schema

Мой JSON куда-то загружается?

Нет. Схема и код генерируются полностью в вашем браузере. Ничего не отправляется в HiAPI или на другие серверы.

Что меняет строгий режим?

Он помечает каждое свойство как required, устанавливает additionalProperties в false и превращает поля, отсутствующие в некоторых элементах массива, в nullable-типы. Строгий структурированный вывод требует всего этого.

Каждая модель поддерживает json_schema?

Нет. Поддержка зависит от модели. В примере используется kimi-k3 с response_format.type, равным json_schema. Что принимает каждая модель, смотрите на её странице.

Как схема выводится из одного примера?

Типы берутся из ваших значений, целые и дробные числа различаются, массивы объединяются по элементам, а строковые форматы добавляются, когда совпадают все образцы. Один пример не покажет перечисления и ограничения значений, поэтому допишите их вручную.

Где находится структурированный результат в ответе?

В choices[0].message.content в виде JSON-строки. Разберите её и провалидируйте бизнес-поля в вашем приложении.