Используйте рабочий процесс Kling V1.6 Multi I2V Pro API на OdiRouter, чтобы отправить несколько эталонных изображений вместе с текстовым запросом, а затем отслеживать поставленную в очередь задачу до готовности видео. OdiRouter документирует модель как kling-v1-6-multi-i2v. Начните с Kling V1.6 multi-image-to-video documentation и не изменяйте этот идентификатор модели в своей интеграции.
Параметры запроса, документированные OdiRouter
Конечная точка очереди — POST /v1/queue/kling-v1-6-multi-i2v в базовом URL API модели OdiRouter. Отправьте image_list и prompt. Документация допускает до четырёх эталонных изображений. Каждый элемент использует ключ image и принимает публично доступный URL изображения или строку Base64.
При передаче URL изображение должно быть общедоступным. При передаче Base64 отправляйте значение Base64 без префикса data:image/...;base64,. В документе OdiRouter указана поддержка форматов JPEG и PNG, ограничение размера файла 10 MB, минимальный размер изображения 300 в пикселях, а также диапазон соотношения сторон входного изображения от 1:2.5 до 2.5:1. API не обрезает изображения, поэтому подготовьте композицию эталонного изображения перед отправкой.
Обязательный запрос имеет документированное максимальное ограничение в 2500 символов. negative_prompt является необязательным и может описывать материал, которого следует избегать. Документированные значения mode — std и pro. duration принимает 5 или 10, а aspect_ratio принимает 16:9, 9:16 или 1:1.
Отправьте запрос на несколько изображений.
Отправьте API-ключ OdiRouter в заголовке Authorization. Этот пример содержит URL-заполнители изображений и заполнитель API-ключа. Замените их значениями из своего приложения.
curl --request POST "https://api.odirouter.ai/model/v1/queue/kling-v1-6-multi-i2v" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"image_list": [
{"image": "https://example.com/reference-one.png"},
{"image": "https://example.com/reference-two.png"}
],
"prompt": "A product camera move that connects the two reference scenes",
"negative_prompt": "blur, distorted subject",
"mode": "pro",
"duration": "5",
"aspect_ratio": "16:9"
}'Ответ содержит request_id и URL-адреса для проверки статуса, получения готового ответа и отмены. Сохраните request_id вместе с записью о задании. OdiRouter также документирует external_task_id для сопоставления запроса с бизнес-процессом. Используйте уникальное значение для каждого пользователя.
Отслеживайте жизненный цикл задачи
Запросы на преобразование изображений в видео выполняются асинхронно. Отправка только создаёт задачу. Проверьте возвращённый status_url, затем используйте response_url, когда задача будет готова. Если приложению нужны события, документированный callback_url может получать обновления статуса. Используйте cancel_url, если отмена должна быть частью окружающего рабочего процесса.
Используйте URL-адреса, возвращаемые при каждой отправке, вместо того чтобы формировать URL самостоятельно. Они относятся к созданной задаче OdiRouter. Обрабатывайте неудачные и отменённые задания в том же пути обработки заданий, что и успешный результат.
Подготовьте полезные эталонные материалы
Выбирайте эталонные изображения с четким сюжетом и задуманной композицией. Опишите в запросе действие, связь между сценами и движение камеры. Добавьте negative_prompt, когда для результата важно конкретное ограничение.
Перед вызовом конечной точки проверьте тип файла, размер файла, публичную доступность для полей ввода URL и размеры изображения. Эти проверки соответствуют документированным правилам ввода и позволяют приложению объяснить пользователю, почему эталонный медиаматериал был отклонён.
Продолжите с OdiRouter
Ознакомьтесь с OdiRouter model documentation, чтобы узнать актуальную схему запроса и ответа. OdiRouter getting-started guide охватывает API-ключи, авторизацию, идентификаторы моделей и первый запрос. Проверьте оба источника, чтобы узнать текущую доступность, ограничения и цены.