Kling 1.6 Standard API. Руководство по отправке видеозаданий.

Редакция OdiRouter

Kling 1.6 Standard API. Для видеопроцесса необходим надёжный способ создать задачу, сохранить её идентификатор, проверять её состояние и получать результат после завершения.

Используйте актуальную первичную документацию как контракт для интеграции. Это позволяет не полагаться на сторонние описания архитектуры model, тестов производительности, доступности или цен. Прежде чем переводить тестовый процесс в production, ознакомьтесь со связанными страницами model и цен.

Найдите документированный маршрут задачи

Документированный маршрут и значения аутентификации:

method: POST /v1/queue/kling-v1-6-t2v
base: https://api.odirouter.ai/model
header: Authorization: Bearer YOUR_API_KEY

В данном справочнике определены следующие поля запроса и параметры вывода:

required: prompt
optional: negative_prompt, cfg_scale, mode, aspect_ratio, duration, watermark_info, callback_url, external_task_id
mode: std (720p), pro (1080p)
aspect_ratio: 16:9, 9:16, 1:1
duration: 5, 10 seconds

Рассматривайте рендеринг как фоновую работу. Интерфейс может показать, что задача отправлена, тогда как запись о задании отслеживает ход progress и предоставляет результат только после того, как сервис сообщит об успешном конечном статусе. Такое разделение позволяет четко определить отправную точку для повторных попыток и работы службы поддержки.

Отправляйте из серверной среды

Храните учётные данные на сервере. Сначала используйте небольшую тестовую сцену, затем подтвердите актуальный справочный материал, прежде чем запускать более масштабный процесс.

export ODIROUTER_API_KEY="replace-with-your-server-side-key"

curl --request POST "https://api.odirouter.ai/model/v1/queue/kling-v1-6-t2v" \
  --header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A quiet street after rain, reflected city lights, slow camera movement",
    "negative_prompt": "blurry, distorted",
    "cfg_scale": 0.5,
    "mode": "std",
    "aspect_ratio": "16:9",
    "duration": "5"
  }'

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

request_id
status_url
response_url
cancel_url

Проверяйте состояние перед получением результата

Ответ на создание означает, что работа принята, а не то, что результат готов. Продолжайте проверять задачу, пока она не достигнет конечного результата, затем отличайте задачу с completed от успешного результата error.

IN_QUEUE
IN_PROGRESS
COMPLETED
error
curl --silent --show-error \
  --header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
  "${STATUS_URL}"

В документации указаны следующие интервалы опроса:

normal checks: 2-5 seconds
longer videos or slower models: 5-10 seconds

Свяжите свою работу со своим личным послужным списком.

Используйте обратный вызов, если ваш сервис может принимать обновления задачи. Используйте внешнее значение задания, если задача должна быть связана с записью в вашей собственной системе. Сохраняйте как собственное значение, так и идентификатор, возвращённый provider. Обратный вызов может сократить количество опросов, однако обработчик всё равно должен проверять его полезную нагрузку и фиксировать конечные errors.

callback_url
external_task_id

Сохраняйте простоту операций

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

Следующие шаги

Используйте эти первичные источники, чтобы проверить актуальный контракт запроса, жизненный цикл задачи, варианты model и цены перед работой в production.

#Отправка видеозаданий#асинхронный видеопроцесс.#проверка статуса заданий