Редактирование видео

Используйте POST /grok/v1/videos/edits, чтобы редактировать исходное видео с помощью текстового Prompt, сохранять движение и получать request_id для асинхронного опроса результатов.

POST /grok/v1/videos/edits

Create an xAI video edit job

cURL

curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'

200

{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

Используйте этот endpoint, чтобы редактировать существующий MP4 с помощью текстовой инструкции. Результат остается ближе к таймингу и композиции исходного клипа, чем при запросе на генерацию с нуля.

​

Перед отправкой запроса

• Укажите доступный video.url
• Исходный клип должен быть коротким; согласно рекомендациям xAI, длительность редактируемого видео ограничена примерно 8.7 секундами
• Используйте точную инструкцию, описывающую одно конкретное изменение
• Сохраните возвращаемый request_id, потому что для edits используется тот же процесс опроса, что и для generation

​

Процесс редактирования

1. Отправьте запрос на редактирование

   Передайте URL исходного видео, prompt для редактирования и model: grok-imagine-video.

2. Опросите финальный результат

   Вызывайте Get Video Generation Results, пока задача не будет завершена.

3. Сохраните отредактированный файл

   Скачайте готовый результат или передайте возвращенный URL в собственный pipeline хранения.

​

Что меняется в CometAPI

В документации xAI редактирование видео описано как тот же асинхронный жизненный цикл, что и генерация, только с исходным видео вместо необязательного исходного изображения. CometAPI сохраняет это поведение и тот же endpoint для опроса, поэтому ваш процесс редактирования по-прежнему выглядит так: запуск -> опрос -> скачивание.

Авторизации

Authorization · string · header · обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json

prompt · string · обязательно

Edit instruction describing the change you want.

Пример:

"Add snow to the scene."

video · object · обязательно

Source video to edit. xAI documents an input limit of about 8.7 seconds.

Show child attributes

model · string · по умолчанию: grok-imagine-video

xAI video model id.

Пример:

"grok-imagine-video"

output · object

Optional output delivery configuration.

user · string

Optional end-user identifier.

Ответ

200 - application/json

Request accepted.

request_id · string · обязательно

Deferred request id used for polling.