DeepSeek API: ключ и первый запрос
API подключает модели DeepSeek к вашему боту, сайту или скрипту. Формат совместим с OpenAI и Anthropic, поэтому готовые SDK обычно достаточно перенастроить: указать другой адрес и новый ключ.
Как получить ключ
- Войдите на платформу разработчика DeepSeek и откройте страницу platform.deepseek.com/api_keys.
- Создайте ключ и сразу сохраните его в менеджере паролей.
- Запишите ключ в переменную окружения DEEPSEEK_API_KEY.
- Проверьте баланс аккаунта: при его нехватке запрос вернёт ошибку 402.
Адрес и модели
Старые имена deepseek-v4-flash и deepseek-v4-flash-vision-exp ещё принимаются, но сами модели выведены: такие запросы обслуживает V4.1 Flash по цене Flash. В новом коде лучше сразу указывать актуальное имя.
- Адрес в формате OpenAI: https://api.deepseek.com.
- Адрес в формате Anthropic: https://api.deepseek.com/anthropic.
- deepseek-flash сейчас обслуживается моделью DeepSeek-V4.1-Flash-1017.
- deepseek-v4-pro — вторая модель в актуальном списке документации.
Первый запрос
Самый короткий способ проверить ключ — выполнить команду в терминале:
curl https://api.deepseek.com/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $DEEPSEEK_API_KEY" -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Привет! Ответь одним словом."}],"stream":false}'
Если вы используете SDK, поменяйте в настройках клиента адрес и ключ. Чтобы получать ответ по частям, передайте stream со значением true. Документация также показывает включение режима размышлений через параметры thinking и reasoning_effort.
Что означают коды ошибок
- 400 и 422: неверный формат тела или параметры. Подсказка есть в тексте ошибки.
- 401: неверный ключ. Проверьте его или создайте новый.
- 402: закончился баланс. Его нужно пополнить.
- 429: слишком частые запросы. Увеличьте паузы и изучите страницу Rate Limit & Isolation.
- 500 и 503: сбой или перегрузка сервера. Повторите запрос после короткого ожидания.
Перед запуском в продукт
Не храните ключ в коде страницы или мобильного приложения: отправляйте запросы через свой сервер. Для кода и математики документация советует temperature 0,0, а для художественных текстов — 1,5. Предусмотрите повтор при ошибках 429 и 503 с растущей паузой, чтобы всплеск нагрузки не останавливал весь сервис.
Нужно написать код подключения?
ИИ-агент LeanTech поможет составить пример запроса под ваш язык программирования. Кнопка откроет агента с готовым заданием.
Поставить задачу →Вопросы и ответы
Совместим ли DeepSeek API с OpenAI SDK?
Да. В документации сказано, что достаточно изменить настройки подключения: адрес и ключ. Для формата Anthropic предусмотрен отдельный адрес.
Какую модель указать в запросе?
В актуальной документации названы deepseek-flash и deepseek-v4-pro. Перед запуском сверьте список: имена и обслуживающие их версии меняются.
Почему API возвращает ошибку 402?
На аккаунте закончились средства. Проверьте баланс на платформе и пополните его. Действующие тарифы указаны на странице Models & Pricing.
Что делать при ошибке 429?
Вы превысили ограничение по частоте или числу одновременных запросов. Разнесите запросы по времени и добавьте автоматический повтор с паузой.
Материал подготовлен независимо от разработчика сервиса. Адреса, модели, параметры и коды ошибок взяты из документации api-docs.deepseek.com (ноябрь 2026 года) и могут меняться.