Перейти к основному содержанию
POST
/
grok
/
v1
/
videos
/
edits
Create an xAI video edit job
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"
  }
}
'
{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

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

1

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

Отправьте URL исходного видео, Prompt редактирования и model: grok-imagine-video.
2

Выполняйте опрос до получения итогового результата

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

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

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

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

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

Авторизации

​
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.

​
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.