Как использовать DeepSeek API за пределами Китая: настройка и проверки

Чтобы использовать DeepSeek API за пределами Китая, сначала выберите сервис, поддерживающий ваш аккаунт и регион размещения. Можно оценить прямую платформу DeepSeek или шлюз, например Tokenhot. В обоих случаях нужны эндпоинт, API-ключ от этого сервиса и идентификатор модели, который действительно поддерживает выбранный маршрут.

Единого значения задержки или правила регистрации для всех стран, аккаунтов и поставщиков не существует. До начала разработки проверьте актуальные варианты регистрации и оплаты в своём регионе. Шлюз — вариант доступа, а не разрешение игнорировать правила доступности сервиса.

Обновлено 14 сентября 2026 года. Примеры кода основаны на документации и не являются измерениями реальной производительности API.

Прямой доступ к DeepSeek или шлюз?

Критерий	DeepSeek напрямую	Шлюз Tokenhot
Эндпоинт	https://api.deepseek.com	https://api.tokenhot.ai/v1
Учётные данные	Ключ платформы DeepSeek	Ключ консоли Tokenhot
Выбор модели	Актуальные идентификаторы в документации DeepSeek API	Точный идентификатор маршрута из каталога Tokenhot
Биллинг	Аккаунт DeepSeek и текущие прямые тарифы	Аккаунт Tokenhot и показанные тарифы шлюза
Главная причина для оценки	Прямые отношения с поставщиком модели	Доступ к нескольким семействам моделей через один сервис

Эндпоинт и настройка SDK описаны в кратком руководстве DeepSeek и кратком руководстве Tokenhot. Ключи привязаны к сервису: не отправляйте ключ DeepSeek в Tokenhot и наоборот.

Если существующий аккаунт DeepSeek уже поддерживает нагрузку, сначала протестируйте этот маршрут. Если нужен более широкий каталог или другие условия аккаунта, сравните шлюзы. Наш обзор альтернатив OpenRouter рассматривает совместимость и выбор поставщика за рамками первого вызова API.

Проверьте название модели, прежде чем копировать старый пример

В актуальном руководстве DeepSeek рекомендуется deepseek-flash. Там сказано, что прежние имена deepseek-v4-flash и deepseek-v4-flash-vision-exp по-прежнему принимаются прямым сервисом, но запросы теперь используют DeepSeek V4.1 Flash, поскольку соответствующие старые модели выведены из эксплуатации. Там же указано, что сервис V4 Pro API продолжит работу после 14 сентября 2026 года. Актуальные идентификаторы DeepSeek API.

Работающий псевдоним не доказывает, что вызывается неизменённая модель. Сохраняйте в конфигурации эндпоинт, запрошенную модель, возвращённые метаданные модели при их наличии и дату проверки.

Не предполагайте, что шлюз следует тем же псевдонимам или графику вывода. Явно выбирайте опубликованный им идентификатор. Исторический выпуск V4 Pro, его тесты и требования к весам разобраны в руководстве DeepSeek V4 Pro.

Сделайте небольшой первый вызов на Python

Установите официальный OpenAI Python SDK, поддерживающий настраиваемые базовые URL и клиенты Chat Completions:

pip install openai

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
    timeout=120.0,
    max_retries=0,
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Explain an API gateway in two sentences."}],
    stream=False,
)
print(response.choices[0].message.content or "")
print(response.usage)

Явный тайм-аут и отключённые автоматические повторы упрощают разбор первого диагностического запуска. Это пример, а не рекомендуемые пределы для каждой нагрузки. Настройте ограниченную политику повторов после изучения ошибок сервиса и временного бюджета приложения.

Для Tokenhot получите ключ в консоли API-ключей, выберите маршрут DeepSeek в каталоге моделей и задайте TOKENHOT_API_KEY и TOKENHOT_MODEL в серверном окружении. Замените конфигурацию клиента и модели на:

client = OpenAI(
    api_key=os.environ["TOKENHOT_API_KEY"],
    base_url="https://api.tokenhot.ai/v1",
    timeout=120.0,
    max_retries=0,
)
model = os.environ["TOKENHOT_MODEL"]

Передайте model=model в тот же базовый вызов Chat Completions. Выбор модели через конфигурацию не закрепляет в примере непроверенный псевдоним шлюза. Храните ключи на сервере, не включайте их в браузерные сборки, публичные репозитории и снимки диагностики.

Добавляйте стриминг и рассуждения отдельно

После успешного базового запроса проверьте стриминг на выбранном маршруте. В потоке Chat Completions убедитесь, что фрагмент содержит choice, прежде чем обращаться к содержимому:

stream = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Give three checks before deploying an API client."}],
    stream=True,
)
try:
    for chunk in stream:
        if chunk.choices:
            text = chunk.choices[0].delta.content
            if text:
                print(text, end="", flush=True)
finally:
    stream.close()

Здесь client и model относятся к выбранной выше конфигурации; для прямого примера укажите model="deepseek-flash". Код печатает содержимое ответа. Не предполагайте, что каждая модель рассуждений помещает промежуточный вывод в буквальные теги <think>. Разбирайте только документированные поля маршрута и отделяйте вспомогательные рассуждения от финального ответа.

Текущий прямой пример DeepSeek использует reasoning_effort вместе с объектом thinking. Это не доказывает, что произвольный шлюз принимает то же расширение и значения. Добавляйте их только после проверки документации маршрута. По той же причине отдельно тестируйте инструменты, структурированный вывод, изображения и длинный контекст: общий клиентский интерфейс не делает все функции взаимозаменяемыми.

Диагностируйте ошибки доступа до смены поставщика

Неудачный запрос сам по себе не доказывает региональную сетевую блокировку. Сначала изучите статус HTTP, сообщение сервиса, эндпоинт и выбранную модель.

Симптом	Первая проверка
Ошибка аутентификации	Ключ создан сервисом, получающим запрос, и ещё действителен?
Недостаточный баланс	На API-аккаунте есть доступные средства для маршрута?
Неверный параметр или модель	Модель принимает отправленные идентификатор, поле и значение?
Лимит запросов	Параллелизм или объём токенов превышает разрешённый уровень аккаунта?
Тайм-аут или перегрузка	Завершается ли небольшой запрос и сообщает ли сервис об инциденте?
Прерванный поток	Соединение закрылось рано, а приложение приняло частичный текст за полный ответ?

DeepSeek документирует 401 для ошибки аутентификации, 402 для недостаточного баланса, 422 для неверных параметров, 429 для ограничения частоты и 500/503 для проблем сервера. Коды шлюза могут отличаться. Читайте справочник ошибок нужного сервиса вместо применения политики повторов одного поставщика ко всем маршрутам. Коды ошибок DeepSeek.

Сохраняйте ID запросов и очищенные метаданные ошибок для поддержки. Не публикуйте API-ключи или закрытые промпты. При повторных сбоях меняйте по одной переменной: ключ, модель, тело запроса или расположение сети.

Измеряйте задержку из региона размещения

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

Используйте одинаковые промпты, параллелизм, настройки вывода и временной интервал. Измеряйте время до первого токена ответа, полное время, долю успехов и оплачиваемое использование. Отмечайте, входит ли установка соединения и приходят ли вспомогательные рассуждения до ответа. При достаточном числе наблюдений отдельно сообщайте медианную и хвостовую задержку.

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

Сравните счёт и условия данных реального маршрута

Используйте текущую цену оплачиваемого эндпоинта. Прямые цены DeepSeek и тарифы шлюза Tokenhot — разные предложения. Кешированный и обычный ввод, вывод рассуждений и временные тарифы меняют итог; сравнение цен LLM API даёт воспроизводимую формулу.

До пополнения проверьте способы оплаты и минимальную сумму для своего аккаунта. Не предполагайте одинаковую поддержку карт и кошельков во всех странах.

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

Перед переходом в рабочую среду

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

Начните с Tokenhot quick start для шлюза или DeepSeek quick start для прямого доступа и оцените маршрут на своей нагрузке до расширения трафика.