Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб надіслати фінальну задачу мультимодального редагування відео після того, як сесію та вибрані параметри буде підготовлено.

Повний робочий процес

1

Ініціалізація сесії редагування

Почніть з Initialize Video for Editing, щоб отримати session_id для кліпу, який ви хочете редагувати.
2

Побудова області виділення

Використовуйте Add Video Selection і, за потреби, Preview Selected Video Area, щоб уточнити область редагування.
3

Надсилання фінальної задачі

Надішліть session_id, edit_mode, фінальний prompt і будь-які необов’язкові налаштування генерації через цей endpoint, а потім збережіть повернутий id задачі для перевірки статусу.

Перед викликом

  • Переконайтеся, що сесію виділення вже ініціалізовано
  • Підтвердьте, що вибір області правильний, перш ніж витрачати виклик генерації
  • Виконуйте подальші виклики для виділення в тому самому акаунті та з точним session_id, повернутим під час ініціалізації
  • Встановіть edit_mode у addition, swap або removal
  • Надайте image_list для addition і swap; не передавайте image_list для removal
  • Передавайте duration як рядок, наприклад "5" або "10"; у прикладах явно передається "5"
  • Розглядайте цей маршрут як фінальний крок генерації, а не крок налаштування
  • Додавайте image_list, negative_prompt, mode, duration, callback_url або external_task_id лише тоді, коли цього потребує робочий процес редагування
Повний довідник параметрів дивіться в документації Kling API.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

application/json
session_id
string
обов'язково

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

edit_mode
enum<string>
обов'язково

Editing operation for the selected video region. Use addition to add an element, swap to replace a selected element, or removal to remove it.

Доступні опції:
addition,
swap,
removal
prompt
string
обов'язково

Instruction describing the desired edit. Reference the source video as <<<video_1>>> and any reference image as <<<image_1>>>.

model_name
enum<string>
за замовчуванням:kling-v1-6

Kling model variant for the final edit task. Omit to use kling-v1-6.

Доступні опції:
kling-v1-6
image_list
object[]

Image references used by addition and swap tasks. Omit this field for removal tasks.

Minimum array length: 1
negative_prompt
string

Elements to avoid in the edited result.

mode
enum<string>

Generation mode. Use std or pro.

Доступні опції:
std,
pro
duration
string

Requested output duration in seconds.

callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Відповідь

200 - application/json

Task accepted.

code
integer
обов'язково
message
string
обов'язково
data
object
обов'язково