Skip to main content
POST
cURL
Sử dụng endpoint này để chỉnh sửa một tệp MP4 hiện có bằng một chỉ dẫn văn bản. Đầ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.

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 chỉ 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ư tạo video

Quy trình chỉnh sửa

1

Gửi yêu cầu chỉnh sửa

Gửi URL video nguồn, prompt chỉnh sửa và model: grok-imagine-video.
2

Polling để lấy kết quả cuối cùng

Gọi Lấy kết quả video xAI cho đến khi tác vụ hoàn tất.
3

Lưu trữ tài nguyên đã chỉnh sửa

Tải đầu ra hoàn tất xuống hoặc đưa 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ì hình ảnh nguồn tùy chọn. CometAPI giữ nguyên hành vi đó và cùng endpoint polling, vì vậy quy trình chỉnh sửa của bạn vẫn là bắt đầu -> polling -> 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.