DeepSeek API — доступ и использование¶
DeepSeek API — это программный интерфейс компании DeepSeek (DeepSeek AI / Hangzhou DeepSeek Artificial Intelligence Basic Technology Research Co., Ltd.), предоставляющий разработчикам доступ к large language models (LLM) семейства DeepSeek-V3 и DeepSeek-R1 через облачный эндпоинт, совместимый с OpenAI API. Для получения доступа требуется регистрация аккаунта и выпуск API-ключа в личном кабинете платформы platform.deepseek.com.
¶Общие сведения
DeepSeek — китайская компания, основанная в 2023 году структурами хедж-фонда High-Flyer. Модели DeepSeek-V3 (генеративная LLM) и DeepSeek-R1 (модель рассуждений, reasoning model) распространяются как проприетарные облачные сервисы и одновременно как открытые веса под лицензией MIT, что позволяет разворачивать их самостоятельно. Облачный API реализован в виде REST-эндпоинта https://api.deepseek.com` и официально объявлен совместимым с форматом OpenAI SDK, что упрощает миграцию существующих приложений.
¶Получение API-ключа
Процесс получения ключа включает следующие шаги:
- Регистрация аккаунта. Создание учётной записи на platform.deepseek.com по адресу электронной почты или через аккаунт Google. Для пользователей из Китая предусмотрена отдельная регистрация через手机号 (номер телефона) на платформе platform.deepseek.com с доменом .cn.
- Подтверждение почты. На указанный адрес отправляется письмо со ссылкой активации.
- Пополнение баланса. Доступ к API предоставляется на платной основе; минимальное пополнение составляет 10 юаней (для китайской версии) или эквивалентную сумму в долларах США для международной версии. Оплата производится картами Visa, Mastercard или через Alipay.
- Выпуск ключа. В разделе «API Keys» личного кабинета создаётся ключ вида
sk-.... Ключ отображается один раз при создании, после чего хранится только в замаскированном виде; рекомендуется сохранить его в безопасном хранилище (например, в переменных окружения).
Ключ используется в заголовке HTTP-запроса Authorization: Bearer <API_KEY> либо передаётся автоматически через SDK.
¶Стоимость и лимиты
Тарификация поставляется в виде цены за миллион токенов, отдельно для входного (prompt) и выходного (completion) текста. Цены на DeepSeek-V3 на момент запуска API в декабре 2024 года составляли 1 юань за 1 млн входных токенов (0,1 юаня в период скидки) и 8 юаней за 1 млн выходных токенов, что делало сервис одним из самых дешёвых на рынке. Для DeepSeek-R1 цена составляла 4 юаня за 1 млн входных и 16 юаней за 1 млн выходных токенов. Кэшированные промпты тарифицируются по сниженной ставке.
Ограничение частоты запросов (rate limit) на аккаунт по умолчанию — 2000 запросов в минуту и 2000 000 токенов в минуту для модели DeepSeek-V3.
¶Использование API
Минимальный запрос к API выполняется через стандартный HTTP POST на эндпоинт /chat/completions:
```python from openai import OpenAI
client = OpenAI( api_key="<deepseek-api-key>", base_url="https://api.deepseek.com"; )
response = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "Привет!"}] ) print(response.choices[0].message.content) ```
Для доступа к модели рассуждений используется идентификатор модели deepseek-reasoner. Помимо OpenAI SDK, официально поддерживаются клиенты для Python, Node.js/TypeScript, а также прямые REST-запросы. DeepSeek также предоставляет совместимый с OpenAI эндпоинт для генерации эмбеддингов и функций вызова инструментов (function calling).
¶Особенности и огранинения
- Географические ограничения. На момент запуска API DeepSeek объявлял, что сервис не доступен из Китайской Народной Республики (кроме отдельной платформы для китайских пользователей) и из стран, находящихся под санкциями США.
- Юридические условия. Пользователи из юрисдикций с санкционными ограничениями обязаны соблюдать экспортный контроль, применяемый к моделям.
- Конфиденциальность. По умолчанию API-запросы и ответы могут использоваться DeepSeek для обучения моделей; эту опцию можно отключить в настройках кабинета.
- Нестабильность нагрузки. В январе–феврале 2025 года, после вирусного роста популярности DeepSeek-R1, компания временно приостанавливала регистрацию новых пользователей из-за перегрузки инфраструктуры и «злоупотреблений» (подразумевались DDoS-атаки).
¶Альтернативы самостоятельному развёртыванию
Поскольку веса моделей опубликованы под лицензией MIT, DeepSeek-V3 и DeepSeek-R1 могут быть развёрнуты локально через Ollama, vLLM, LM Studio или аналогичные инструменты, что исключает необходимость в API-ключе и облачной подписке. Для запуска DeepSeek-R1 локально требуется от 16 ГБ видеопамяти (для квантованной версии 7B) до нескольких сотен гигабайт для полной 671-миллиардной версии с архитектурой MoE.
¶Источники
- Документация DeepSeek API (api-docs.deepseek.com)
- Официальный сайт и личный кабинет platform.deepseek.com
- Лицензионные условия и модельные карты моделей DeepSeek на GitHub