Гайд · TNWS AI

Как получить корректный JSON из DeepSeek API и проверить его схемой

WindowsmacOSLinuxDeepSeek#DeepSeek#API#нейросети
2 мин

Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как получить 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 повторно проверяются сервером.
  • Оборванный по лимиту ответ нельзя чинить регулярным выражением.

Пошаговая проверка

  1. Проверьте запрос с номером, без номера и с двумя номерами.
  2. Строка «заказ миллион» не должна превращаться в числовой ID.
  3. При незавершённом ответе парсер обязан вернуть ошибку до записи в БД.

Чего не делать

  • Не публикуйте API-ключ и не передавайте его браузеру.
  • Не записывайте результат в базу без проверки структуры.
  • Не делайте бесконечные повторы после 401, 429 или 5xx.
  • Не называйте уверенный текст доказанным фактом.

Ограничения

Доступность моделей, контекст, лимиты и цена зависят от актуальной версии сервиса и аккаунта. Сначала запускайте небольшой тест на обезличенных данных. Для важных решений используйте первичный источник и независимую проверку.

FAQ

Можно ли использовать пример в production?

Только после добавления таймаутов, обработки ошибок, лимитов и защиты секретов.

Как выбрать модель?

Сверить текущий список моделей и возможности в официальной документации непосредственно перед внедрением.

Нужно ли проверять ответ модели?

Да: формат — валидатором, факты — источником или базой, вычисления — обычным кодом.

Почему нет фиксированной цены?

Цены меняются и зависят от модели; используйте актуальную официальную страницу тарификации.

Официальный источник

Проверено 12 сентября 2026 года: https://api-docs.deepseek.com/guides/json_mode

Читайте также

Комментарии

Пока тихо. Скажите первое слово