Гайд · TNWS AI
Как получить корректный JSON из DeepSeek API и проверить его схемой
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как получить JSON DeepSeek API».
JSON mode помогает получить синтаксически корректный объект, но приложению всё равно нужен JSON.parse и валидатор схемы. В промпте явно укажите, какие поля обязательны и как обозначать отсутствие данных; иначе модель может вернуть правильную форму с выдуманным значением.
Рабочий пример
const r=await client.chat.completions.create({
model:"deepseek-chat",
response_format:{type:"json_object"},
messages:[{role:"user",content:'Верни JSON {"intent":"order|support|other","order_id":string|null}. Ничего не выдумывай.'}]
});
const obj=JSON.parse(r.choices[0].message.content);
if(!["order","support","other"].includes(obj.intent)) throw Error("schema");
Что важно в реализации
- JSON mode проверяет формат, но не истинность данных.
- Nullable-поле лучше вымышленного ID.
- Enum и required повторно проверяются сервером.
- Оборванный по лимиту ответ нельзя чинить регулярным выражением.
Пошаговая проверка
- Проверьте запрос с номером, без номера и с двумя номерами.
- Строка «заказ миллион» не должна превращаться в числовой ID.
- При незавершённом ответе парсер обязан вернуть ошибку до записи в БД.
Чего не делать
- Не публикуйте API-ключ и не передавайте его браузеру.
- Не записывайте результат в базу без проверки структуры.
- Не делайте бесконечные повторы после 401, 429 или 5xx.
- Не называйте уверенный текст доказанным фактом.
Ограничения
Доступность моделей, контекст, лимиты и цена зависят от актуальной версии сервиса и аккаунта. Сначала запускайте небольшой тест на обезличенных данных. Для важных решений используйте первичный источник и независимую проверку.
FAQ
Можно ли использовать пример в production?
Только после добавления таймаутов, обработки ошибок, лимитов и защиты секретов.
Как выбрать модель?
Сверить текущий список моделей и возможности в официальной документации непосредственно перед внедрением.
Нужно ли проверять ответ модели?
Да: формат — валидатором, факты — источником или базой, вычисления — обычным кодом.
Почему нет фиксированной цены?
Цены меняются и зависят от модели; используйте актуальную официальную страницу тарификации.
Официальный источник
Проверено 12 сентября 2026 года: https://api-docs.deepseek.com/guides/json_mode
Читайте также
Как использовать reasoning-модель DeepSeek и получить финальный ответ без потери контекста
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как использовать DeepSeek reasoning API».
Как настроить function calling в DeepSeek API и безопасно выполнить инструмент
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как настроить function calling DeepSeek».
Как подключить DeepSeek API через OpenAI SDK: base URL, ключ и первый запрос
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как подключить DeepSeek API».
Комментарии
Пока тихо. Скажите первое слово