Быстрый старт мультимодального API ИИ | OdiRouter

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

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

Начните с учётной записи, API-ключа и небольшого теста

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

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

Выберите поток запросов, соответствующий задаче

В документации к OdiRouter разделяются два шаблона запросов.

• Запросы к LLM используют https://api.odirouter.ai/v1. Документированные интерфейсы включают /chat/completions, /messages и /responses. Используйте интерфейс, подходящий для поддерживаемого вами SDK или кода приложения.

• Для задач обработки мультимодальных медиаданных используется протокол https://api.odirouter.ai/model и асинхронный протокол /v1/queue/{endpoint}. Отправьте задачу, сохраните её идентификатор запроса, проверьте её статус, затем получите завершённый ответ по URL-адресам, возвращённым для этой задачи.

Это различие определяет, как должно вести себя приложение. Запрос в стиле чата может соответствовать взаимодействию типа «запрос — ответ». Для изображения, видео, аудио или другой поставленной в очередь нагрузки требуется жизненный цикл задания. Показывайте состояние ожидания и восстанавливайтесь после задержанной или неудачной задачи вместо того, чтобы считать первый HTTP-ответ окончательным результатом.

Отправьте минимальный запрос к LLM

Для запроса к LLM используйте документированные базовый URL и аутентификацию Bearer. Выберите актуальную модель из OdiRouter model catalog вместо того, чтобы переносить выбор модели из старого руководства.

export ODIROUTER_API_KEY="YOUR_API_KEY"

curl -sS "https://api.odirouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer $ODIROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Summarize this request in one sentence."}
    ]
  }'

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

Рассматривайте асинхронную медиазадачу как задание

Для поставленной в очередь мультимодальной задачи первый успешный ответ — это идентификатор, а не итоговый медиарезультат. Сохраните возвращённый request_id вместе с рабочим элементом. Документированный ответ задачи также содержит URL-адреса статуса и ответа для этого запроса.

Ваш работник может следовать простому циклу:

1. Отправьте одну задачу на документированный конечный адрес очереди для выбранной модели.

2. Сохраните request_id и URL-адрес возвращаемого состояния.

3. Опрашивайте URL-адрес состояния с заданным интервалом времени, пока задача находится в очереди или выполняется.

4. После завершения задачи запросите URL-адрес ответа и проверьте результат, прежде чем отображать его пользователю.

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

Перейдите от тестирования к производственному процессу

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

Доступность моделей и цены могут меняться. Сделайте выбор модели и проверку стоимости частью развертывания вместо того, чтобы копировать в продукт статическое сравнение. Используйте актуальный OdiRouter pricing page для сравнения цен доступных моделей и возвращайтесь к официальной документации при изменении поведения конечной точки или SDK.

Продолжите с OdiRouter

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