Для рабочего процесса Kling Video O3 4K text-to-video API сначала проверьте, какие данные в настоящее время доступны в вашей учетной записи OdiRouter. Доступность видеомоделей, их идентификаторы и ограничения для каждой модели изменяются. Начав с каталога, вы привязываете своё приложение к актуальным данным OdiRouter, а не к скопированному эндпоинту или устаревшей таблице цен.
OdiRouter объединяет текстовые, графические, видео-, аудио- и 3D-модели на одной платформе. Справочник по списку моделей документирует фильтры по категории, провайдеру, входной модальности, выходной модальности и ключевому слову. Сначала проверьте каталог, затем изучите сведения о модели, которую планируете использовать.
Начните с поиска видеомоделей
Каталог отвечает на два первоочередных вопроса: доступна ли видеомодель для вашего API-ключа и какой идентификатор модели и документированный маршрут следует использовать. В официальном справочнике видео указано как категория, а Kling — как фильтр по провайдеру.
curl --request GET \
--url "https://api.odirouter.ai/v1/models/catalog?category=video&provider=Kling" \
--header "Authorization: Bearer YOUR_API_KEY"Рассматривайте ответ как текущий контракт интеграции. Сохраните идентификатор модели, выбранной вашим приложением. Проверьте её категорию, провайдера, модальность и описание. Если ожидаемая модель отсутствует, не переходите на похожий маршрут. Сообщите пользователю, что она недоступна, или позвольте ему выбрать другую возвращённую видеомодель.
Используйте OdiRouter models page для просмотра актуальных вариантов. model-list reference объясняет фильтры и поля ответа.
Перед созданием задания проверьте модель.
Название модели не является контрактом для производственного использования. Перед отправкой запроса получите подробную информацию о текущей модели и ознакомьтесь с соответствующей документацией по модели OdiRouter. Проверьте способ ввода, способ вывода, обязательные поля, допустимые значения, требования к файлам и документированный маршрут для данного идентификатора модели.
Это позволяет избежать кода, предполагающего, что каждая видеомодель поддерживает одинаковые поля для промпта, длительности, соотношения сторон, референсного изображения или аудио. Создайте схему запроса на основе документации для модели, возвращённой каталогом. Храните схему в версионируемой конфигурации приложения, а не на маркетинговой странице или в клиентской константе.
Рассматривайте поставленную в очередь работу как жизненный цикл.
Некоторые операции с видео используют задания в очереди. Если выбранная модель использует асинхронный процесс, сохраните идентификатор запроса и возвращённый статус или URL-адреса ответа. Выполняйте опрос с ограниченным интервалом, останавливайтесь при документированном конечном состоянии и сохраняйте расположение результата только после успешного ответа.
Подходите к повторным попыткам осознанно. Используйте в своём сервисе стратегию идемпотентности, чтобы тайм-аут сети не создавал дублирующиеся задания на генерацию. Отделяйте повторные попытки отправки от повторных попыток проверки статуса. Сохраняйте достаточно метаданных запроса, чтобы можно было объяснить, какая модель и какие настройки создали результат. Не размещайте ключи API в коде браузера, журналах, сгенерированных страницах или сообщениях об ошибках клиента.
Выполните небольшой проверочный запрос.
После выбора модели и проверки ее документированных входных данных проведите тест с низким уровнем риска. Убедитесь, что учётная запись может создать задание, что жизненный цикл завершается в соответствии с документацией и что выходные данные имеют ожидаемый тип медиа. Перед использованием рабочего процесса в более крупном производственном конвейере, проверьте полученный результат.
Используйте этот тест также для настройки обработки подсказок. Сосредоточьте промпт на объекте, действии, окружении, замысле работы камеры и визуальном стиле, которые влияют на результат. Добавляйте только элементы управления, поддерживаемые документацией модели. Если существуют дополнительные элементы управления, протестируйте их по одному, чтобы увидеть, какие изменения вносит каждый из них.
Контрольный список для промышленной интеграции видео
Выполните запрос к каталогу OdiRouter с фильтрами, соответствующими задаче.
Используйте идентификатор модели, возвращённый для ключа API, который будет отправлять запрос.
Получите актуальные сведения о модели перед созданием специфичных для неё входных данных.
Храните учётные данные на сервере и скрывайте их в диагностических данных.
Записывайте идентификаторы запросов, идентификаторы моделей, конечный статус и проверенные метаданные выходных данных.
Повторно проверяйте доступность каталога при изменении развёртываний или решений по маршрутизации.
Начните с OdiRouter
Запрос Kling Video O3 4K text-to-video API — это задача текущего поиска моделей, а не фиксированное обещание интеграции. Создайте учётную запись OdiRouter, ознакомьтесь с documentation, изучите доступный видеокаталог и используйте справочные материалы для модели, к которой имеет доступ ваша учётная запись.