Сегодня вряд ли кого-то удивишь тем, что DeepSeek стал одной из самых обсуждаемых моделей. Быстрая, дешёвая, открытая по весам. Но одно дело потыкать в чатик, другое - подключить API и встроить модель в свой проект. И тут у многих начинается боль.
Я сам наступил на грабли с документацией, которая написана в стиле «вот тебе пример, дальше разберёшься». Поэтому сейчас покажу на пальцах, как подключить DeepSeek API, чтобы вы не теряли полдня. Заодно расскажу, что делать, если вы из России и с оплатой проблемы.
С чего начать: API-ключ DeepSeek
Первое, что нужно сделать - зарегистрироваться на платформе DeepSeek. Переходите на platform.deepseek.com (это не chat.deepseek.com, не перепутайте), создаёте аккаунт и идёте в раздел API Keys. Там жмёте кнопку создания нового ключа. Ключ начинается с sk-, так что сразу копируйте его куда-нибудь, потому что второй раз он не покажется.
Важный момент: за API нужно платить. DeepSeek продаёт токены, и пополнение баланса обычно требует иностранную карту. Вот тут начинается развлечение. Если у вас карты нет, можно использовать сторонние сервисы, о которых я расскажу в конце, но пока идём по классике.
Когда ключ на руках, идём дальше.
Настройка окружения: переменная DEEPSEEK_API_KEY
Секреты в коде хранить нельзя, это аксиома. Поэтому DeepSeek просит вынести ключ в переменную окружения. Делается это просто. В терминале на Linux или macOS пишете:
export DEEPSEEK_API_KEY="ваш_ключ"На Windows PowerShell:
$env:DEEPSEEK_API_KEY="ваш_ключ"Если не хотите светить ключ в каждом новом окне терминала, можно добавить строку в ~/.bashrc или ~/.zshrc. Но для разовой проверки подойдёт и так.
Первый запрос через curl
API DeepSeek совместим с форматом OpenAI, поэтому все примеры для OpenAI работают после замены base_url. Вот минимальный запрос:
curl -X POST "https://api.deepseek.com/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-d '{
"model": "deepseek-flash",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
}'В ответ придёт JSON с выборкой модели. Если хотите стриминг, добавьте параметр "stream": true. Но в curl это не так удобно, как в Python-клиенте.
Подключаем DeepSeek API через Python
Тут всё ещё проще. Ставим официальный SDK от OpenAI, потому что DeepSeek не пилил свой клиент:
pip3 install openaiА потом просто код:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("DEEPSEEK_API_KEY"),
base_url="https://api.deepseek.com"
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
]
)
print(response.choices[0].message.content)Обратите внимание на base_url. Если забыть его переопределить, SDK будет стучаться на api.openai.com. На Reddit это одна из самых частых ошибок - я сам через неё прошёл.
Аналогично на Node.js - можно использовать openai пакет, указав тот же base URL. Вся документация по API, кстати, лежит на api-docs.deepseek.com, если захотите копнуть глубже.
Интеграция с Codex: одна команда
Отдельная фишка - подключить DeepSeek к Codex, CLI-агенту от OpenAI. Если вы работаете с Codex, то можете вместо стандартной модели использовать deepseek-flash или deepseek-v4-pro. Это делается скриптом в один клик.
Клонируете репозиторий, запускаете скрипт, и он спрашивает ваш API-ключ. Первый вариант в меню - настроить Codex на deepseek-flash, второй - на deepseek-v4-pro, девятый - откатить изменения. Всё, дальше Codex ходит в DeepSeek, а вы экономите кучу денег.
Если не хотите запускать чужой скрипт, можно руками отредактировать конфиг. Находите файл ~/.codex/config.toml (или создаёте), и пишете туда что-то вроде:
model_provider = "deepseek"
experimental_bearer_token = "ваш_ключ"В общем, ничего сложного.
Обходной путь для России: 3GPT от 3SELLER
Теперь про боль, о которой я обещал. DeepSeek API требует иностранную карту для оплаты. Из России купить токены напрямую - тот ещё квест. Я долго искал рабочий вариант, и в итоге нашёл 3GPT от 3SELLER.
Это ИИ-роутер, который даёт доступ ко всем флагманским моделям нейросетей прямо из России. Не нужно ни VPN, ни иностранных карт. Пополняете баланс обычной российской картой, через СБП или криптой. И получаете доступ к свежим моделям:
- Chat GPT 6 Astra
- Claude Fable 5
- Claude Fable 5.1
- Claude Opus 5.5
- Chat GPT 5.5
- Chat GPT 6.1 Sol
- Nano Banana для генерации изображений
Плюс генерация видео, обработка картинок, голос. Всё это за 149 рублей в месяц. Выглядит подозрительно дёшево, но работает. Я к нему пришёл именно ради DeepSeek, когда понял, что картой платить не выйдет. И не пожалел: тот же OpenAI-совместимый формат, те же запросы, просто меняешь base_url на их адрес.

ИИ-агенты под ваши задачи
У 3SELLER есть ещё одна классная штука - готовые ИИ-агенты. Это не просто чат с моделью, а настроенные сценарии под конкретные задачи: написать продающий текст, сгенерировать картинку, собрать сайт. Модель агента можно менять прямо в чате, так что вы не привязаны к одному варианту.
Вот ссылка на каталог агентов: https://3seller.com/ai/agents

Заходите, выбираете агента, общаетесь. Если нужно - меняете модель. Удобно, когда не хочется каждый раз писать одни и те же промпты.
Несколько советов перед стартом
Если вы всё-таки решите использовать DeepSeek API напрямую, вот что знаю из практики:
- Всегда храните ключ в переменных окружения, а не в коде.
- Для Python используйте OpenAI SDK, но не забывайте про
base_url. - Модель deepseek-flash дешевле и шустрая, а deepseek-v4-pro - умнее. Выбирайте под задачу.
- Если нужно выжать максимум из нейросетей и не париться с оплатой из России, смотрите в сторону 3GPT.
Попробуйте сначала на маленьких запросах, посмотрите, как отвечает модель, и только потом масштабируйте. А если нужен полный доступ ко всем модным моделям без головной боли - вот ссылка, пригодится: https://3seller.com/3gpt