Tài liệu tham khảo API
Hướng dẫn tích hợp
Giá & Thanh toán
xAI
Tạo video
Sử dụng CometAPI POST /grok/v1/videos/generations để tạo video với Grok, animate một ảnh đầu vào bằng prompt, và thăm dò kết quả qua request_id.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}Sử dụng endpoint này để khởi động một tác vụ video Grok từ văn bản, hoặc từ văn bản kèm một ảnh nguồn. Endpoint sẽ trả về
request_id ngay lập tức, vì vậy hãy xem đây là bước đầu tiên trong một quy trình async.
Bắt đầu với một yêu cầu nhỏ
- Sử dụng
model: grok-imagine-video - Để kiểm tra nhanh, giữ
durationở1vàresolutionở480p - Chỉ thêm
image.urlkhi bạn muốn tạo image-to-video - Nếu bạn gửi base64, hãy giữ nguyên định dạng trong tài liệu và ví dụ OpenAPI là
data:image/png;base64,<BASE64_IMAGE_DATA>
Luồng tác vụ
Thăm dò đến khi hoàn tất
Gọi Get Video Generation Results cho đến khi trạng thái provider lồng nhau chuyển thành
done.Điều gì thay đổi trên CometAPI
xAI mô tả quy trình tạo video là luồng hai bước start -> poll. CometAPI giữ nguyên cùng cấu trúc request và cùng model id cốt lõi, nhưng bạn xác thực bằng khóa CometAPI của mình và sử dụng base URL của CometAPI. Một yêu cầu trực tiếp 1 giây 480p đã hoàn tất thành công vào ngày 2026-03-12 và trả về một URL kết quả thực tế.Ủy quyền
Bearer token authentication. Use your CometAPI key.
Nội dung
application/json
Prompt for the video job.
Ví dụ:
"A candle flickers on a wooden table."
Output aspect ratio.
Tùy chọn có sẵn:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Ví dụ:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Tùy chọn có sẵn:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Phản hồi
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}