Kling Video O1 Справочник по API для видео | OdiRouter

Редакция OdiRouter

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

Сначала ознакомьтесь с текущей страницей модели OdiRouter

Параметры модели могут меняться. Перед отправкой рабочего запроса ознакомьтесь с Kling Video O1 documentation, чтобы узнать о поддерживаемых параметрах, и с текущей страницей OdiRouter model catalog, чтобы проверить доступность. Также проверьте актуальные цены на странице модели, а не используйте цену, скопированную у другого поставщика.

OdiRouter's Model API overview описывает мультимодальную генерацию как асинхронный процесс с очередью. Сохраните возвращённый идентификатор запроса и используйте документированные URL-адреса статуса и ответа. Не ожидайте, что в отправленном ответе будет содержаться готовое видео.

Целенаправленно выбирайте эталонные входные данные.

Документированный интерфейс Kling Video O1 принимает промпт, а также необязательные входные данные image_list, video_list и element_list. Каждый тип входных данных действует как отдельный управляющий сигнал.

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

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

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

  • Сосредоточьте промпт на действии, поведении камеры, окружении и тайминге, которые вы хотите видеть в новом видео.

Референс не объясняет все части желаемого результата. Краткий, конкретный промпт задаёт направление, которого не может обеспечить входной ресурс. Прежде чем добавлять необязательные поля, проверьте документацию модели на предмет допустимых комбинаций и ограничений.

Отправьте запрос на создание видео в очередь

OdiRouter документирует конечную точку отправки Kling Video O1 как https://api.odirouter.ai/model/v1/queue/kling-video-o1. Следующая структура представляет собой пример интеграции. Замените URL изображения-заполнителя и ключ API значениями, которыми вы управляете, и отправляйте только поля, поддерживаемые текущей документацией модели.

curl --request POST "https://api.odirouter.ai/model/v1/queue/kling-video-o1" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A product on a clean studio table slowly turns toward the camera.",
    "image_list": [
      { "image": "https://example.com/reference-image.png" }
    ],
    "aspect_ratio": "16:9",
    "duration": "5"
  }'

Сохраняйте полезную нагрузку в журналах приложения, не записывая секреты. Сохраните возвращённые request_id, status_url и response_url, чтобы воркер мог возобновить опрос после перезапуска. Если сервис возвращает ошибку валидации, исправьте указанное поле, а не повторяйте отправку той же полезной нагрузки.

Опросите статус, затем получите результат

Надёжный клиент рассматривает отправку и завершение как отдельные этапы.

  1. Отправьте запрос в конечную точку очереди Kling Video O1.

  2. Считывайте возвращенное значение status_url до тех пор, пока задача не достигнет конечного состояния.

  3. Получайте завершенные выходные данные от response_url только после того, как документированный статус укажет на завершение.

  4. Используйте возвращённый cancel_url только в том случае, если документация модели указывает, что отмена поддерживается, и вашему приложению необходимо остановить задачу.

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

Используйте контрольный список производства.

Перед выпуском проверьте детали, специфичные для выбранной модели и ваших исходных ресурсов.

  • Убедитесь, что ваша учётная запись может использовать Kling Video O1 и что текущая страница модели соответствует параметрам, которые вы планируете отправлять.

  • Используйте ресурсы, на отправку которых у вас есть разрешение. Не размещайте секреты в промпте, общедоступном URL или клиентском бандле.

  • Проверьте URL референсов, а также предполагаемые aspect_ratio и duration перед постановкой запроса в очередь.

  • Зафиксируйте request_id и обрабатывайте пути статуса, результата и ошибки в рамках одного жизненного цикла задачи.

  • Перед планированием больших объёмов работ ознакомьтесь с актуальными ценами и спецификациями модели на OdiRouter.

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

Создайте учётную запись OdiRouter, чтобы получить ключ API, затем используйте getting-started documentation с Kling Video O1 reference. Это позволяет привязать интеграцию к поддерживаемому интерфейсу, а не к устаревшей копии страницы модели.

Источники

#API для генерации эталонного видео#API для сопоставления ссылки с видео Kling Video O1#OdiRouter Kling Video O1