DeepSeek API Key: получение, оплата и вызовы (2026)

API DeepSeek благодаря невысокой цене и сильным навыкам работы с китайским языком массово используется в поддержке клиентов, написании текстов, программировании и анализе данных. Ниже с точки зрения ZSQH AI Gateway разобрано, как получить ключ, пополнить счёт, вызвать модель через OpenAI SDK и что делать при ограничении скорости.

В статье используется OpenAI-совместимый интерфейс. Официальный интерфейс DeepSeek также совместим с OpenAI SDK, но Base URL и имена моделей отличаются — не смешивайте их.

1. Что умеет DeepSeek API

Типичные задачи:

вопросы и ответы на китайском, чат-боты поддержки;
суммирование, перевод и переписывание длинных текстов;
генерация и объяснение кода;
анализ данных и структурированное извлечение;
узлы рассуждения в агентах и рабочих процессах.

Распространённые модели DeepSeek — deepseek-chat и deepseek-reasoner. Актуальные имена, длина контекста и цены смотрите на странице цены на модели.

2. Регистрация и создание ключа

Откройте ZSQH AI Gateway, зарегистрируйтесь и войдите.
Перейдите на страницу «API-ключи» и нажмите «Создать».
Укажите имя deepseek-test или deepseek-prod.
Задайте лимит расходов и срок действия.
Скопируйте ключ и сохраните в надёжном месте.

Рекомендуется создавать отдельные ключи для теста и производства. Производственный ключ нельзя размещать во фронтенд-коде.

3. Пополнение

Пополнение выполняется на странице «Кошелёк». После зачисления баланс отображается в консоли.

При первом использовании рекомендуется внести небольшую сумму и скорректировать её по фактическому расходу. Цена DeepSeek относительно невысока, но длинный контекст и пакетные задачи всё равно могут быстро израсходовать баланс.

4. Base URL и имена моделей

OpenAI-совместимый адрес ZSQH:

https://ai.zhongshangqihang.com/v1

Примеры имён моделей:

deepseek-chat
deepseek-reasoner

Обратите внимание:

Имена моделей смотрите на странице цен; не копируйте старые названия из официальной документации.
При использовании официального интерфейса DeepSeek Base URL — https://api.deepseek.com; при использовании шлюза указывайте адрес выше.
Не смешивайте два Base URL, иначе появятся 401/404.

5. Вызов из Python

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "Ты технический помощник."},
        {"role": "user", "content": "Объясни в трёх предложениях, что такое векторная база данных"},
    ],
)

print(response.choices[0].message.content)

Если нужен процесс рассуждения, переключитесь на deepseek-reasoner. Учтите, что рассуждающие модели обычно медленнее и дороже; они подходят для трудных задач, но не для каждого запроса.

6. Вызов через curl

export DEEPSEEK_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Напиши пример чтения CSV на Python"}
    ]
  }'

7. Ограничения скорости и стабильность

В пиковые часы DeepSeek может ограничивать скорость или отвечать медленнее. Практические рекомендации:

Задавайте тайм-аут и повторы: не ждите бесконечно; для 429/5xx используйте экспоненциальную задержку.
Контролируйте параллелизм: не запускайте пакетную задачу на полную мощность сразу.
Подготовьте резервную модель: для критичных процессов настройте запасную модель или канал.
Следите за долей ошибок: считайте 401/429/5xx по часам и при отклонении переключайте канал.
Делите длинные тексты: слишком длинный контекст медленный и дорогой; сначала делайте резюме или разбивайте на части.

8. Частые ошибки

Ошибка	Причина	Что делать
`401`	Неверный ключ или отсутствует Bearer	Проверьте ключ и заголовки
`404`	Неверный Base URL	Используйте адрес шлюза, заканчивающийся на `/v1`
`model not found`	Неверное имя модели	Скопируйте со страницы цен
`429`	Ограничение скорости	Снизьте параллелизм, повторите, переключите резервный канал
`insufficient quota`	Недостаточно средств	Пополните баланс
Медленный ответ	Пиковая нагрузка или длинный контекст	Сократите контекст, смените модель, повторите

9. Официальный DeepSeek или шлюз

Параметр	Прямое подключение	Шлюз ZSQH
Доступ	Зависит от сети	Единый вход, обычно стабильнее
Оплата	Способы, поддерживаемые поставщиком	Пополнение на сайте
Модели	Только DeepSeek	Можно одновременно подключить Claude, GPT, Gemini и другие
Биллинг	Панель поставщика	Единая консоль
Переключение	При смене поставщика нужно править код	Достаточно изменить имя модели

Если вы используете только DeepSeek, объём стабилен и официальный доступ работает нормально, прямое подключение тоже подойдёт. Если нужны несколько моделей, единый счёт или стабильный доступ из Китая, шлюз удобнее.

10. Рекомендации по безопасности

Не встраивайте ключ во фронтенд или публичный репозиторий.
Создавайте отдельные ключи для теста и производства.
Задавайте лимит расходов, чтобы избежать аномальных вызовов.
Регулярно просматривайте журнал расходов и при отклонениях сразу отключайте ключ.
При уходе сотрудника или смене машины удаляйте старый ключ.

Частые вопросы

Можно ли пользоваться DeepSeek API бесплатно?

Обычно есть квота для новых пользователей или акции, но для долгосрочной работы требуется пополнение. Ориентируйтесь на официальные правила и правила на сайте.

Можно ли одним ключом вызывать Claude?

В ZSQH AI Gateway один ключ может вызывать несколько открытых моделей; модель указывается в параметрах запроса. Подробности смотрите на странице цен.

Почему одна и та же модель отвечает то быстро, то медленно?

На это влияют загрузка вышестоящего сервиса, длина контекста, параллелизм и сеть. В производстве рекомендуется настроить тайм-ауты, повторы и резервную модель.

Что дальше

Зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ deepseek, проверьте его через curl и подключите к приложению. Цены и имена моделей смотрите на странице цены на модели.