Kling V3 - Text to Video

kling-v3-t2v Kling V3 - Text to Video улучшает многообъектные эффекты, обеспечивая более плавную обработку взаимодействий и лучшие переходы движения.

Эндпоинты

POST /v1/queue/kling-v3-t2v # Создать задачу

GET /v1/queue/kling-v3-t2v/requests/{request_id}/status # Проверить статус

GET /v1/queue/kling-v3-t2v/requests/{request_id}/response # Получить результат

PUT /v1/queue/kling-v3-t2v/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-t2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
  "negative_prompt": "blurry, low quality, distorted",
  "sound": "on",
  "cfg_scale": 0.5,
  "mode": "std"
}'

multi_shot boolean

Генерировать ли видео из нескольких шотов

Когда этот параметр равен true и shot_type равен customize, параметр prompt не применяется

Когда этот параметр равен false, параметры shot_type и multi_prompt не применяются

По умолчанию: false

shot_type string

Тип шота

Когда параметр multi_shot равен true, этот параметр обязателен

customize: пользовательская раскадровка

intelligence: интеллектуальная раскадровка

Варианты: customize, intelligence

prompt string

Промпт для генерации видео, может содержать положительные и негативные описания

Максимум 2500 символов

Когда multi_shot равен false или shot_type равен intelligence, этот параметр не может быть пустым

multi_prompt array

Промпты для отдельных шотов, могут содержать положительные и негативные описания

Последовательность шотов, соответствующие промпты и длительность задаются через параметры index, prompt и duration:

- Поддерживается до 6 шотов, минимум 1 шот

- Максимальная длина содержимого каждого шота не должна превышать 512 символов

- Длительность каждого шота не должна превышать общую длительность текущей задачи и должна быть не меньше 1

- Сумма длительностей всех шотов должна равняться общей длительности текущей задачи

Формат ключ:значение:

"multi_prompt": [
  {
    "index": int,
    "prompt": "string",
    "duration": "5"
  },
  {
    "index": int,
    "prompt": "string",
    "duration": "5"
  }
]

Когда multi_shot равен true и shot_type равен customize, этот параметр не может быть пустым

negative_prompt string

Негативный текстовый промпт

Рекомендуется добавлять негативные ограничения прямо в позитивный промпт через отрицательные формулировки

Максимум 2500 символов

cfg_scale float

Параметр управления свободой генерации видео

Чем выше значение, тем меньше свобода генерации

Диапазон: [0, 1]

По умолчанию: 0.5

sound string

Генерировать ли звук при создании видео

Варианты: on, off

По умолчанию: off

mode string

Режим генерации видео

std: стандартный режим, базовый режим с генерацией видео 720P, выгодный по стоимости

pro: профессиональный режим высокого качества, генерирует видео 1080P с более высоким качеством

4k: режим 4K, выходное разрешение 4K

Базовые разрешения Kling 3.0: 720P, 1080P, 4K

Варианты: std, pro, 4k

По умолчанию: std

aspect_ratio string

Соотношение сторон видео (ширина:высота)

Варианты: 16:9, 9:16, 1:1

По умолчанию: 16:9

duration string

Длительность видео в секундах

Варианты: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

По умолчанию: 5

watermark_info array

Генерировать ли одновременно результат с водяным знаком

Задается параметром enabled:

"watermark_info": {
  "enabled": boolean
}

Пользовательские водяные знаки сейчас не поддерживаются

callback_url string

Адрес обратного вызова для уведомлений о результате этой задачи. Если он задан, сервер будет отправлять уведомления при изменении статуса задачи

external_task_id string

Пользовательский ID задачи

Пользовательский ID задачи. Он не перезаписывает системный ID, но позволяет искать задачу по этому ID

Убедитесь, что значение уникально в рамках одного пользователя

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-t2v/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используемый для последующих операций.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции