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

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

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

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

1

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

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

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

Вызывайте Получить результаты видео xAI, пока задача не будет завершена.
3

Сохраните отредактированный ресурс

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

Что меняется в 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.

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.