Chuyển đến nội dung chính
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"
}
Sử dụng endpoint này để chỉnh sửa một tệp MP4 hiện có bằng một hướng dẫn văn bản. Kết quả đầu ra sẽ bám sát hơn với nhịp thời gian và bố cục của clip nguồn so với một yêu cầu tạo mới hoàn toàn.

Trước khi gửi request

  • Cung cấp video.url có thể truy cập được
  • Giữ clip nguồn ngắn; hướng dẫn riêng của xAI giới hạn chỉnh sửa ở khoảng 8,7 giây
  • Sử dụng một hướng dẫn tập trung, mô tả một thay đổi rõ ràng
  • Lưu request_id được trả về, vì chỉnh sửa sử dụng cùng luồng polling như quá trình tạo

Luồng chỉnh sửa

1

Gửi request chỉnh sửa

Gửi URL video nguồn, edit prompt và model: grok-imagine-video.
2

Polling kết quả cuối cùng

Gọi Get Video Generation Results cho đến khi tác vụ hoàn tất.
3

Lưu asset đã chỉnh sửa

Tải xuống kết quả hoàn chỉnh hoặc chuyển URL được trả về vào pipeline lưu trữ của riêng bạn.

Những gì thay đổi trên CometAPI

xAI mô tả việc chỉnh sửa video có cùng vòng đời bất đồng bộ như tạo video, chỉ khác là dùng video nguồn thay vì một hình ảnh nguồn tùy chọn. CometAPI giữ nguyên hành vi đó và cùng một endpoint polling, vì vậy workflow chỉnh sửa của bạn vẫn là bắt đầu -> poll -> tải xuống.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
prompt
string
bắt buộc

Edit instruction describing the change you want.

Ví dụ:

"Add snow to the scene."

video
object
bắt buộc

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

model
string
mặc định:grok-imagine-video

xAI video model id.

Ví dụ:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

Phản hồi

200 - application/json

Request accepted.

request_id
string
bắt buộc

Deferred request id used for polling.