Руководство по модели Runway API и видеокартам | OdiRouter

Редакция OdiRouter

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

У этого руководства есть важное ограничение: оно не обещает прямой доступ к Runway, если в актуальном каталоге OdiRouter отсутствует конечная точка, предназначенная специально для Runway.

Проверьте доступность, прежде чем проектировать интеграцию

Каталоги моделей быстро меняются. По состоянию на август 7 года в публичной карте сайта моделей 2026 и в карте сайта его документации не было ни модели, предназначенной специально для OdiRouter, ни URL-адреса документации для Runway. В той же публичной документации были перечислены семейства видео, включая Hailuo, PixVerse, Kling, Vidu, HappyHorse и Wan.

Это наблюдение, актуальное на указанную дату, а не постоянное заявление о продукте. Перед выбором конечной точки проверьте актуальный каталог: https://odirouter.ai/models

Если вашему приложению требуется именно Runway, не заменяйте его моделью с похожим названием и не копируйте конечную точку у другого провайдера. Используйте идентификатор модели, только если он указан на актуальной странице модели OdiRouter или в API списка моделей: https://odirouter.ai/docs/api-reference/models/model-list

Определите необходимую вам задачу по работе с видео

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

  • Для преобразования текста в видео проверьте длительность, соотношение сторон, разрешение, ограничения для промптов, негативные промпты и настройки камеры.

  • Для преобразования изображения в видео проверьте допустимые форматы, размер файла, размеры изображения, средства управления движением и требования к первому кадру.

  • Для преобразования референсов в видео проверьте количество и назначение референсов, а также подтвердите, что у вас есть разрешение на их загрузку.

  • Для редактирования видео проверьте кодек, длительность клипа, лимит загрузки, поддерживаемые правки и обработку аудио.

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

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

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

Запишите требования

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

  1. Зафиксируйте тип входных данных и максимальный размер.

  2. Установите требуемую длительность, разрешение, соотношение сторон и выходной формат.

  3. Определите, какие элементы управления важны: текстовый промптинг, обусловливание изображением, референсы, редактирование, расширение или апскейлинг.

  4. Установите приемлемое время ожидания в очереди, тайм-аут запроса и поведение при повторных попытках.

  5. Проверьте текущую единицу тарификации и оцените стоимость с учетом реальных параметров задачи.

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

  7. Спланируйте, как приложение будет хранить идентификатор запроса, опрашивать статус, получать результаты и сообщать о сбоях.

  8. Проверьте эндпоинт в актуальном каталоге OdiRouter перед реализацией и повторно перед выпуском.

Цены могут меняться, поэтому логика приложения не должна полагаться на значение, скопированное со сторонней страницы. Сравните текущие опубликованные цены на https://odirouter.ai/pricing

Следуйте процессу выполнения задач OdiRouter

OdiRouter использует асинхронные задачи для изображений, аудио, видео и 3D-моделей. Его документированный базовый URL для мультимодальных запросов — https://api.odirouter.ai/model,, а запросы используют аутентификацию Bearer.

Процесс прост:

  1. Выберите идентификатор эндпоинта на актуальной странице модели OdiRouter.

  2. Отправьте задачу с помощью POST /v1/queue/{endpoint}.

  3. Сохраните идентификатор запроса и опрашивайте /v1/queue/{endpoint}/requests/{request_id}/status.

  4. После завершения задания получите /v1/queue/{endpoint}/requests/{request_id}/response. Используйте документированный путь отмены, если вашему продукту нужна отмена.

Полезная нагрузка зависит от модели. Сформируйте payload.json на странице выбранной модели, затем отправьте его из своего бэкенда:

export ODIROUTER_API_KEY="YOUR_API_KEY"
export ODIROUTER_ENDPOINT="APPROVED_MODEL_ENDPOINT"

curl -X POST "https://api.odirouter.ai/model/v1/queue/\${ODIROUTER_ENDPOINT}" \
  -H "Authorization: Bearer \${ODIROUTER_API_KEY}" \
  -H "Content-Type: application/json" \
  --data-binary @payload.json

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

См. краткое руководство по адресу https://odirouter.ai/docs/get-started/quick-start и обзор протокола по адресу https://odirouter.ai/docs/model-api/overview

Сравнивайте альтернативы по выполняемой ими работе

Современная видеомодель полезна только в том случае, если она соответствует поставленной задаче. Не описывайте один вариант как эквивалентный Runway, если OdiRouter или разработчик модели не публикует доказательства наличия именно этой возможности.

Сравните кандидатов, отображаемых в рабочем каталоге, по следующим параметрам:

  • Поддерживает ли модель преобразование текста в видео, изображения в видео, референса в видео, редактирование, расширение или апскейлинг?

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

  • Какие параметры управления задокументированы, например, соотношение сторон, продолжительность, поведение камеры, начальное значение или отрицательные подсказки?

  • Как работают отправка, статус очереди, отмена, хранение результатов и ошибки?

  • Какие разрешение, длительность, кодек, поведение аудио, водяные знаки и срок действия URL результата следует ожидать приложению?

  • Каковы текущие единица тарификации, правила параллельного выполнения, ограничения частоты запросов, тайм-ауты и требования к повторным попыткам?

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

Сделайте асинхронные задания видимыми

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

  • Сохраняйте идентификатор запроса рядом с пользовательским заданием и идентификатором эндпоинта.

  • Выполняйте опрос с ограниченной задержкой вместо интенсивного цикла.

  • Отображайте отдельные состояния: в очереди, выполняется, завершено, отменено и ошибка.

  • Сохраняйте сведения о провайдере в серверных журналах, возвращая пользователю понятное сообщение.

  • Проверяйте URL результатов и переносите необходимые ресурсы в одобренное хранилище до истечения срока действия временных ссылок.

  • Применяйте ограничения затрат и параллельного выполнения для каждого приложения.

  • Во время проверки релиза повторно проверяйте доступность модели и цены.

Текущее руководство по настройке мультимодальности содержит базовый URL, схему аутентификации и правило для эндпоинтов: https://odirouter.ai/docs/model-api/multimodal/setup

Выберите следующий шаг

Если прямой доступ Runway обязателен, проверьте его в актуальном каталоге OdiRouter, прежде чем писать код. Если базовая потребность — это видеопроцесс, сравните актуальные одобренные эндпоинты по их документированным входным данным, элементам управления, выходным данным и поведению задач.

Просматривайте актуальные модели по адресу https://odirouter.ai/models,, сравнивайте актуальные цены по адресу https://odirouter.ai/pricing, и используйте краткое руководство OdiRouter для первого запроса из бэкенда.

#API для видео с использованием ИИ#API для генерации видео#OdiRouter Model API#Runway API