Ответ в 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.