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

Авторизації

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