Людям, ищущим Runway Gen-4 Aleph API, обычно нужно получить ответы на два практических вопроса. Доступна ли модель для API-ключа OdiRouter, который они планируют использовать, и как выглядит жизненный цикл задачи после выбора совместимого эндпоинта? Публикация о выпуске, результат поиска или сторонний каталог не могут ответить на первый вопрос применительно к конкретной учётной записи. Сначала проверьте каталог, затем разрабатывайте с учётом документированного процесса обработки очереди.
Общедоступный каталог видео OdiRouter помогает находить модели. model catalogue API documentation описывает каталог, доступный для текущего API-ключа. Публичная проверка для этой статьи не выявила записи, соответствующей Runway или Aleph. Это не доказывает, что модель недоступна. Однако это означает, что в этом руководстве не следует обещать её доступность.
Проверьте модель для API-ключа, который вы будете использовать
Просмотрите OdiRouter Models или каталог видео, затем используйте процесс получения списка моделей для ключа, который будет выполнять запросы в рабочей среде. OdiRouter документирует фильтры по категории, поставщику, модальности и ключевому слову. Используйте эти фильтры для проверки имени, не рассматривая само имя как доказательство того, что модель может быть названа.
Когда вы найдёте подходящий вариант, сохраните краткую запись о выборе: название, возвращённое каталогом, документированный эндпоинт, модальность, документированные требования к входным данным и дату проверки. Если в каталоге нет подходящего варианта, остановитесь и выберите документированную альтернативу. Предполагаемая конечная точка не является планом интеграции.
Рассматривайте запрос от СМИ как задачу.
OdiRouter quick start охватывает вход в систему, создание ключа API, пополнение счёта перед использованием в продакшене и выполнение первого запроса. В описании Model API overview многомодальный путь представлен как асинхронная очередь. Отправка, отслеживание задач и получение результатов должны быть реализованы в отдельных частях вашего приложения.
Документированная последовательность действий следующая:
Выберите конечную точку, указанную в документации для проверенной модели.
Создайте задачу с помощью
POST /model/v1/queue/{endpoint}.Сохраните возвращённые
request_idи URL-адреса задач.Опрашивайте ресурс статуса, пока задача не будет завершена или не вернёт ошибку.
Получите ответ после завершения или обработайте сообщённую ошибку.
В успешном ответе create-task documentation перечисляет request_id, response_url, status_url и cancel_url. Сохраните их вместе с записью о задании. Если рабочий процесс перезапустится, эти значения подскажут ему, какую задачу возобновить и где её проверить.
Встройте обработку статусов в интеграцию
status documentation различает IN_QUEUE, IN_PROGRESS, COMPLETED и состояния ошибок. Выполняйте опрос с учётом этих состояний, а не с фиксированным временем ожидания. IN_QUEUE означает, что запрос еще не запущен. IN_PROGRESS означает, что выполнение всё ещё продолжается. Когда статус — COMPLETED, приложение может обработать возвращённый результат. Записывайте ошибки вместе с подробными сведениями об ответе и обрабатывайте их по типу, вместо того чтобы повторять попытки без ограничений.
Используйте метод ограниченного опроса и установите крайний срок выполнения задания, соответствующий вашему продукту. Храните request_id, статус, временные метки и расположение результата в собственной системе. Когда пользователь отменяет задание или рабочий процесс достигает крайнего срока, используйте документированный маршрут отмены для выбранной конечной точки. Это полезно как для одной утвержденной модели размещения рекламы, так и для более широкого набора рабочих процессов.
Контрольный список для продакшена для именованной модели
Убедитесь, что ключ API OdiRouter содержит модель и что документированная конечная точка соответствует требуемой модальности.
Сохраняйте актуальное имя модели, конечную точку и требования к входным данным в записи об интеграции.
Отправьте задачу, сохраните
request_idи протестируйте полный жизненный цикл от статуса до результата.Поддерживайте
IN_QUEUE,IN_PROGRESS,COMPLETED, отмену и ошибки.Повторно проверяйте каталог и документацию при изменении модели, конечной точки, учётной записи или производственного рабочего процесса.
Продолжите работу с документацией OdiRouter
Используйте OdiRouter quick start, чтобы создать ключ API и выполнить первый запрос. Затем ознакомьтесь с model catalogue API, Model API overview и документацией для модели, доступной вашей учётной записи. Такая последовательность привязывает интеграцию к актуальной документации, а не к предположению, связанному с поисковым запросом.