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
обязательно