DeepSeek V4 API на OdiRouter: руководство по настройке

Редакция OdiRouter

У DeepSeek V4 API есть два маршрута OdiRouter: deepseek-v4-pro и deepseek-v4-flash-0731. Любой из них можно вызывать через одну и ту же конечную точку Chat Completions. Важно выбрать правильный идентификатор модели, проверить, к чему имеет доступ ваша учетная запись, и протестировать маршрут до того, как он будет доступен для производственного трафика.

Два маршрута OdiRouter

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

Используйте deepseek-v4-pro или deepseek-v4-flash-0731 в точности в указанном виде. Переведённая метка или сокращённое название не позволит идентифицировать тот же маршрут API.

0731 Pro или Flash?

DeepSeek описывает V4 Pro как более крупную предварительную модель в семействе V4. Она имеет 1.6 триллионов параметров всего, 49 миллиардов активированных параметров и контекст длиной в один миллион токенов. В официальной карточке модели она представлена как модель для сложной работы со знаниями, программирования, рассуждений и задач с длинным контекстом.

Flash 0731 появилась позже. DeepSeek называет её официальным выпуском Flash, заменяющим предварительную версию и обладающим более развитыми агентными возможностями. В его карточке модели также документированы уровни усилий рассуждения low, high и max.

Используйте deepseek-v4-pro, когда маршрут Pro и его более крупный профиль модели подходят для задачи. Протестируйте deepseek-v4-flash-0731, если вам нужен более новый релиз Flash или вы оцениваете поведение агентов. Название не определяет выбор. Запустите оба варианта на промптах, похожих на вашу реальную рабочую нагрузку, затем сравните задержку, качество вывода, поведение инструментов и текущую стоимость.

Настройте клиент OdiRouter

OdiRouter использует следующий базовый URL-адрес LLM:

https://api.odirouter.ai/v1

Аутентификация указывается в заголовке Authorization в виде токена bearer. Храните ключ в переменной окружения, а не в репозитории.

Документация по настройке: https://odirouter.ai/docs/model-api/llm/setup

Документация Chat Completions: https://odirouter.ai/docs/model-api/llm/chat

Сначала отправьте небольшую просьбу.

Этот пример Curl вызывает маршрут Pro. Измените только значение модели на deepseek-v4-flash-0731, если хотите протестировать Flash 0731.

curl --location 'https://api.odirouter.ai/v1/chat/completions' \
  --header "Authorization: Bearer $ODIROUTER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "deepseek-v4-pro",
    "messages": [
      {
        "role": "user",
        "content": "Summarize the main risks in this deployment plan."
      }
    ],
    "temperature": 0.2,
    "max_tokens": 600
  }'

Первое приглашение к вводу должно быть кратким, а вывод должен быть ограничен. Перед добавлением больших документов или дополнительных параметров модели убедитесь, что ваш клиент понимает, что означает успешный ответ, а что — ошибка.

Используйте OpenAI Python SDK

OdiRouter документирует OpenAI SDK с пользовательским базовым URL-адресом. Тот же подход работает с указанным здесь идентификатором модели Pro.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ODIROUTER_API_KEY"],
    base_url="https://api.odirouter.ai/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": "List the validation checks for this API migration.",
        }
    ],
    temperature=0.2,
    max_tokens=600,
)

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

Для честного сравнения маршрутов сохраняйте неизменными промпт и настройки запроса. Измените идентификатор модели — и ничего больше. Это даст вам более ясное представление о различиях, важных для вашего приложения.

Проверьте актуальный каталог перед развертыванием

Каталог моделей OdiRouter сообщает, что может использовать текущий ключ API. Наличие записи на общедоступной веб-странице не гарантирует одинаковый доступ для каждой учетной записи.

curl --location 'https://api.odirouter.ai/v1/models/catalog?keyword=deepseek-v4&provider=DeepSeek' \
  --header "Authorization: Bearer $ODIROUTER_API_KEY"

Документация каталога: https://odirouter.ai/docs/api-reference/models/model-list

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

Осознанно работайте с длинным контекстом

Карточка модели DeepSeek V4 Pro указывает контекст модели объёмом в один миллион токенов. Это число не означает, что каждый запрос, близкий к лимиту, разумен или доступен для каждой учётной записи. Текущие лимиты маршрута OdiRouter, политика учётной записи, формат запроса и цена по-прежнему применяются.

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

Согласуйте параметры рассуждений с маршрутом

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

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

Производственные проверки

Выполните следующие проверки до поступления реального трафика:

  1. Убедитесь, что идентификатор модели вашего ключа API отображается в каталоге.

  2. Ознакомьтесь с актуальными сведениями о ценах и контексте для маршрута.

  3. Выполните небольшой запрос без потоковой передачи.

  4. Явно обрабатывайте тайм-ауты, ограничения частоты запросов и повторные попытки.

  5. Проверяйте в приложении длину вывода и структурированные данные.

  6. Не допускайте попадания учётных данных и конфиденциального содержимого промптов в журналы.

  7. Протестируйте резервный маршрут на случай недоступности выбранной модели.

Актуальные цены указаны на странице цен в реальном времени: https://odirouter.ai/pricing

Часто задаваемые вопросы

Указывает ли OdiRouter обе модели DeepSeek V4?

Да. OdiRouter указывает deepseek-v4-pro и deepseek-v4-flash-0731 в своей карте сайта моделей и на публичных страницах моделей. Используйте каталог моделей, чтобы подтвердить доступ для вашего ключа API.

Какой идентификатор модели указывать в запросе?

Для Pro используйте deepseek-v4-pro. Для более позднего выпуска Flash используйте deepseek-v4-flash-0731. Если вы не определились, выполните одинаковые репрезентативные промпты через оба маршрута.

Совместим ли формат запроса с OpenAI?

Да. В документации OdiRouter по Chat Completions используется совместимый с OpenAI формат messages и показана конфигурация OpenAI SDK с базовым URL OdiRouter.

Могу ли я начать с запроса на один миллион токенов?

DeepSeek документирует контекст в один миллион токенов для V4 Pro. Прежде чем планировать запрос такого размера, проверьте активный лимит OdiRouter, доступ учётной записи, цены и поведение запросов.

Официальные источники

Откройте актуальную страницу модели OdiRouter для маршрута, который планируете использовать, подтвердите её текущие сведения и выполните небольшой запрос с собственным ключом.

#DeepSeek V4 API#DeepSeek V4 Flash 0731#DeepSeek V4 Pro API#OdiRouter