Гайд · TNWS AI

Как подключить DeepSeek API через OpenAI SDK: base URL, ключ и первый запрос

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

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

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

  1. Попросите ровно три строки и проверьте число строк кодом.
  2. Отправьте неверное имя модели: приложение должно вернуть контролируемую ошибку.
  3. Смоделируйте 429 и убедитесь, что повтор ограничен и выполняется с задержкой.

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

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

Ограничения

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

FAQ

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

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

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

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

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

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

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

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

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

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

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

Комментарии

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