Весело
Весело

Ответ в JSON (structured output)

Как получить от нейросети ответ в JSON: response_format json_object и json_schema, проверка ответа и повтор. Примеры для DeepSeek.

Обновлено:

Когда ответ читает программа, а не человек, попроси модель отвечать в JSON. Есть два режима, оба задаются полем response_format.

РежимЧто даётГде работает
{"type": "json_object"}ответ — корректный JSON; поля описываешь в тексте запросамодели с response_format в supported_parameters
{"type": "json_schema", "json_schema": {…}}ответ по твоей JSON Schema: нужные поля и типымодели со structured_outputs в supported_parameters

JSON-объект

Напиши в сообщении слово JSON и перечисли поля: часть моделей без этого режим не включает.

curl

curl https://veselo.ai/v1/chat/completions \
  -H "Authorization: Bearer $VESELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash-ultrafast",
    "max_tokens": 200,
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": "Извлеки имя, город и возраст. Ответь только JSON с полями name, city, age."},
      {"role": "user", "content": "Меня зовут Аня, мне 27, живу в Перми."}
    ]
  }'

Python

import json
import os
from openai import OpenAI

client = OpenAI(base_url="https://veselo.ai/v1", api_key=os.environ["VESELO_API_KEY"])

r = client.chat.completions.create(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    messages=[
        {"role": "system", "content": "Извлеки имя, город и возраст. Ответь только JSON с полями name, city, age."},
        {"role": "user", "content": "Меня зовут Аня, мне 27, живу в Перми."},
    ],
    response_format={"type": "json_object"},
    max_tokens=200,
)
person = json.loads(r.choices[0].message.content)
print(person["name"], person["city"], person["age"])

Текст ответа

{"name": "Аня", "city": "Пермь", "age": 27}

JSON по схеме

Схема — обычная JSON Schema. С "strict": true модель держится схемы строже; для этого в required перечисли все поля и поставь "additionalProperties": false.

Python

import json
import os
from openai import OpenAI

client = OpenAI(base_url="https://veselo.ai/v1", api_key=os.environ["VESELO_API_KEY"])

schema = {
    "type": "object",
    "properties": {
        "name": {"type": "string"},
        "city": {"type": "string"},
        "age": {"type": "integer"},
    },
    "required": ["name", "city", "age"],
    "additionalProperties": False,
}
r = client.chat.completions.create(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    messages=[{"role": "user", "content": "Извлеки имя, город и возраст в JSON: «Меня зовут Аня, мне 27, живу в Перми»."}],
    response_format={"type": "json_schema", "json_schema": {"name": "person", "strict": True, "schema": schema}},
    max_tokens=200,
)
person = json.loads(r.choices[0].message.content)
print(person)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://veselo.ai/v1', apiKey: process.env.VESELO_API_KEY });

const r = await client.chat.completions.create({
  model: 'deepseek/deepseek-v4.1-flash-ultrafast',
  max_tokens: 200,
  messages: [{ role: 'user', content: 'Извлеки имя, город и возраст в JSON: «Меня зовут Аня, мне 27, живу в Перми».' }],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'person',
      strict: true,
      schema: {
        type: 'object',
        properties: { name: { type: 'string' }, city: { type: 'string' }, age: { type: 'integer' } },
        required: ['name', 'city', 'age'],
        additionalProperties: false,
      },
    },
  },
});
const person = JSON.parse(r.choices[0].message.content);
console.log(person);

Проверяй ответ

  • Разбирай ответ через json.loads или JSON.parse и проверяй нужные поля. Не прошло — повтори запрос; можно добавить сообщение с текстом ошибки.
  • Модель, которая не поддерживает режим, может его пропустить: ответить обычным текстом или обернуть JSON в блок кода Markdown. Поэтому режим — дополнение к просьбе в тексте, а не замена.
  • Если finish_reason — length, JSON обрезан: подними max_tokens.

← Вызов функций · Провайдеры →

Вся документация одним текстом · Все модели и цены