Перейти до основного вмісту
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"
}
Використовуйте цей 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 для опитування, тож ваш процес редагування, як і раніше: старт -> опитування -> завантаження.

Авторизації

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.