Grok Video API

Trang này mô tả cách gọi các model video Grok của xAI, grok-imagine-video và grok-imagine-video-1.5. Giống các model video khác, chúng được tạo bằng POST /v1/videos và truy vấn bằng GET /v1/videos/{id}; xác thực, trạng thái truy vấn định kỳ, tải kết quả và xử lý lỗi xem Quy chuẩn gọi Video API đầy đủ. Trang này chỉ trình bày các trường và quy tắc riêng của Grok.

Cập nhật ngày 2026-10-10. grok-imagine-video-1.5-1080p cũ đã ngừng cung cấp; cần 1080P thì dùng grok-imagine-video-1.5 kèm "resolution": "1080p". Grok đặt tỷ lệ khung hình bằng aspect_ratio (hoặc ratio, size). Grok chỉ hỗ trợ truy vấn định kỳ, không đặt callback_url.

Model

Tham số

• Độ phân giải: resolution nhận 480p, 720p; grok-imagine-video-1.5 nhận thêm 1080p. Cũng có thể đặt trong metadata.resolution.
• Thời lượng: số giây nguyên từ 1 đến 15 trong duration (hoặc seconds dạng chuỗi).
• Tỷ lệ khung hình: aspect_ratio và ratio tương đương nhau, cũng có thể ghi tỷ lệ vào size (ví dụ "size": "9:16"); size không nhận kích thước pixel. Khi điền nhiều trường tỷ lệ cùng lúc (kể cả trong metadata), các giá trị phải giống nhau, nếu không sẽ trả về 400.
• Ảnh: tối đa một ảnh, dùng URL https:// công khai, đặt trong images, image hoặc input_reference. Cùng một ảnh ghi vào hai trường mỗi trường một lần sẽ bị tính là 2 ảnh và trả về 400.
• Prompt: có thể bỏ trống prompt khi có ảnh; nếu không có cả hai sẽ trả về 400.
• Không hỗ trợ: khung hình đầu và cuối, video tham chiếu, âm thanh tham chiếu, negative_prompt, seed, generate_audio, tải tệp lên bằng multipart/form-data.

Văn bản thành video

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Siêu xe màu bạc trong thành phố đêm mưa, máy quay góc thấp bám theo, phản chiếu ánh đèn neon, chất điện ảnh",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p"
}

Ảnh thành video

{
  "model": "grok-imagine-video",
  "prompt": "Giữ chủ thể trong ảnh tham chiếu, máy quay lùi chậm từ cận cảnh, chất điện ảnh",
  "duration": 6,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "images": ["https://cdn.example.com/start.jpg"]
}