Гайд · TNWS AI
Как подключить DeepSeek API через OpenAI SDK: base URL, ключ и первый запрос
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как подключить DeepSeek API».
DeepSeek предоставляет OpenAI-совместимый интерфейс: в клиенте меняют API key и baseURL на https://api.deepseek.com, после чего вызывают chat completions. Совместимость не означает полного совпадения всех моделей и параметров — их нужно сверять с документацией DeepSeek.
Рабочий пример
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com"
});
const r = await client.chat.completions.create({
model:"deepseek-chat",
messages:[{role:"user",content:"Верни 3 проверки SEO-заголовка"}],
max_tokens:400
});
console.log(r.choices[0].message.content);
Что важно в реализации
- Ключ хранится только на сервере.
- Текст находится в
choices[0].message.content, но сначала проверяются HTTP-код, choices и finish_reason. - Usage сохраняют для контроля входных и выходных токенов.
- Имя модели нельзя угадывать: используйте актуальное из документации.
Пошаговая проверка
- Попросите ровно три строки и проверьте число строк кодом.
- Отправьте неверное имя модели: приложение должно вернуть контролируемую ошибку.
- Смоделируйте 429 и убедитесь, что повтор ограничен и выполняется с задержкой.
Чего не делать
- Не публикуйте API-ключ и не передавайте его браузеру.
- Не записывайте результат в базу без проверки структуры.
- Не делайте бесконечные повторы после 401, 429 или 5xx.
- Не называйте уверенный текст доказанным фактом.
Ограничения
Доступность моделей, контекст, лимиты и цена зависят от актуальной версии сервиса и аккаунта. Сначала запускайте небольшой тест на обезличенных данных. Для важных решений используйте первичный источник и независимую проверку.
FAQ
Можно ли использовать пример в production?
Только после добавления таймаутов, обработки ошибок, лимитов и защиты секретов.
Как выбрать модель?
Сверить текущий список моделей и возможности в официальной документации непосредственно перед внедрением.
Нужно ли проверять ответ модели?
Да: формат — валидатором, факты — источником или базой, вычисления — обычным кодом.
Почему нет фиксированной цены?
Цены меняются и зависят от модели; используйте актуальную официальную страницу тарификации.
Официальный источник
Проверено 12 сентября 2026 года: https://api-docs.deepseek.com/
Читайте также
Как использовать reasoning-модель DeepSeek и получить финальный ответ без потери контекста
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как использовать DeepSeek reasoning API».
Как настроить function calling в DeepSeek API и безопасно выполнить инструмент
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как настроить function calling DeepSeek».
Как получить корректный JSON из DeepSeek API и проверить его схемой
Практическое руководство: рабочий пример, структура ответа, ограничения, негативные тесты и проверка результата для запроса «как получить JSON DeepSeek API».
Комментарии
Пока тихо. Скажите первое слово