Чтобы начать использовать DeepSeek V4, перейдите к просмотру каталога в реальном времени. Не копируйте идентификатор модели из старой публикации. На момент исследования этого руководства OdiRouter Models указывал DeepSeek V4 Flash 0731 как deepseek-v4-flash-0731. Перед развертыванием снова проверьте каталог или GET https://api.odirouter.ai/v1/models. Названия моделей и их доступность могут меняться.
Затем выполните один небольшой запрос. Этого достаточно, чтобы убедиться, что ваш ключ, идентификатор модели, конфигурация клиента и обработка ответа работают совместно. OdiRouter документирует способ через OpenAI SDK, поэтому существующий OpenAI-совместимый клиент может использовать API-ключ OdiRouter и базовый URL OdiRouter.
Что подготовить
Вам понадобятся учетная запись и API-ключ OdiRouter, актуальный идентификатор модели DeepSeek V4, установленный OpenAI SDK и короткий промпт с легко проверяемым ответом. Не храните ключ в репозитории, истории командной оболочки и расшифровках чатов.
OdiRouter introduction охватывает API-ключи, авторизацию, идентификаторы моделей, первый запрос и настройку SDK. Если в вашем проекте уже есть клиент OpenAI, используйте OpenAI SDK guide.
Проверьте идентификатор модели
Страница Models удобна для сравнения вариантов в браузере. В развертывании или скрипте запросите у конечной точки моделей точный идентификатор, возвращаемый для варианта DeepSeek V4, который вы планируете использовать. Это позволяет избежать догадок после переименования, недоступности или вывода модели из эксплуатации.
Приведённый ниже код использует deepseek-v4-flash-0731, видимый идентификатор флэш-памяти DeepSeek V4 0731, используемый в процессе исследования. Это лишь пример, а не непреходящая ценность.
Настройте OpenAI SDK на OdiRouter
Поместите свой ключ OdiRouter в переменную среды или в менеджер секретов вашего развертывания. Не указывайте его значение в исходном коде.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ODIROUTER_API_KEY"],
base_url="https://api.odirouter.ai/v1",
)В документации SDK OdiRouter используется тот же базовый URL. Ваш клиент сохраняет привычную структуру запросов OpenAI SDK, а OdiRouter получает запрос для выбранной модели.
Сделайте первый запрос, который вы сможете проверить.
Используйте короткий запрос со строгим форматом ответа. Вы сможете быстро проверить, работают ли аутентификация, идентификатор модели и анализатор ответов, прежде чем добавлять реальный контекст приложения.
response = client.chat.completions.create(
model="deepseek-v4-flash-0731",
messages=[
{
"role": "system",
"content": "Answer in exactly two bullet points.",
},
{
"role": "user",
"content": "List two checks to run before deploying a new model ID.",
},
],
)
print(response.choices[0].message.content)Прежде чем продолжить, проверьте результат:
Ключ был получен из окружения и не попал в журнал.
API принял идентификатор модели из текущего каталога.
Ответ соответствует запрошенному формату из двух пунктов.
Ваше приложение обрабатывает пустой ответ или ошибку API, не раскрывая ключ.
Превратите тест в интеграцию
После того как короткий запрос заработает, добавляйте реальную задачу постепенно. Начните с безопасных входных данных, не используемых в рабочей среде. Укажите идентификатор модели в конфигурации приложения. Если ответ должен соответствовать схеме, укажите эту схему в запросе и проверьте её в коде до выполнения автоматизированного действия.
Проверяйте сгенерированный код перед запуском. Для создания сводок или извлечения данных используйте данные, соответствующие утверждённым правилам их обработки. Успешный запрос не доказывает, что модель подходит для любых входных данных, поэтому перед расширением трафика используйте репрезентативные тестовые случаи.
Устранение распространённых проблем настройки
Идентификатор модели не работает.
Вернитесь к OdiRouter Models или позвоните по номеру GET https://api.odirouter.ai/v1/models. Используйте текущий возвращаемый идентификатор вместо того, чтобы создавать его на основе имени семейства моделей.
SDK сообщает об ошибке аутентификации
Убедитесь, что переменная среды вашего API-ключа присутствует в среде процесса и что базовый URL-адрес клиента равен https://api.odirouter.ai/v1. При отладке не вставляйте ключ в запрос, задачу или исходный файл.
Ответ не соответствует требуемому формату
Сведите первую задачу к краткой инструкции с четким представлением результата. Проверьте свой анализатор на успешных, пустых и некорректно сформированных ответах. Добавляйте больше контекста только после того, как небольшой тест станет надёжным.
Продолжите работу с официальными справочными материалами
Откройте OdiRouter Models, чтобы проверить модель. Затем воспользуйтесь getting started documentation или OpenAI SDK setup guide. Когда будете готовы к интеграции, начните с OdiRouter и явно укажите в конфигурации идентификатор модели, API-ключ и условия тестирования.
Часто задаваемые вопросы
Какой идентификатор модели DeepSeek V4 следует использовать?
Используйте точный идентификатор, указанный в разделе OdiRouter Models или возвращаемый GET https://api.odirouter.ai/v1/models. Во время исследования в каталоге для DeepSeek V4 Flash 0731 был указан deepseek-v4-flash-0731, но перед развертыванием проверьте его ещё раз.
Может ли существующий клиент OpenAI SDK работать с OdiRouter?
Да. В документации OpenAI SDK OdiRouter указано, что клиент следует настроить с API-ключом OdiRouter и https://api.odirouter.ai/v1 в качестве базового URL-адреса. Сведения о настройке для конкретного языка см. в официальном руководстве.
Следует начать с чата или API-запроса?
Для интеграции в приложение начните с одного небольшого API-запроса. Он проверяет учётные данные, идентификатор модели, путь запроса и обработку ответа в среде, где будет работать ваше приложение.