Grok Imagine Video 1.5

Tạo clip Grok Imagine Video 1.5 dài 6–15 giây có âm thanh từ prompt hoặc một ảnh, ở 480p hoặc 720p, tính phí theo giây và giao kết quả qua tác vụ.

Grok Imagine Video 1.5 là mô hình video của xAI. Một yêu cầu tạo một clip 6–15 giây có âm thanh từ prompt, hoặc từ prompt cùng một ảnh, ở 480p hoặc 720p với tỷ lệ 16:9, 9:16 hoặc 1:1. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc video hoàn chỉnh từ tác vụ. Ảnh được truyền vào dưới dạng URL.

ID mô hình

ID mô hình	Đầu vào	Độ phân giải	Độ dài
`grok-imagine-video-1-5`	văn bản, một ảnh	`480p`, `720p`	6–15 giây

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Header	Giá trị
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn chỉnh. Hãy truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Hãy giữ khóa API trong code phía máy chủ.

Tham số

Trường	Kiểu	Mặc định	Ghi chú
`model`	string	bắt buộc	`grok-imagine-video-1-5`
`prompt`	string	bắt buộc	Tối đa 10.000 ký tự. Vẫn bắt buộc khi có ảnh.
`image_urls`	danh sách URL	không có	Tối đa một ảnh. Có ảnh thì clip là ảnh thành video; không có thì là văn bản thành video.
`resolution`	enum	`480p`	`480p` hoặc `720p`.
`duration`	integer	`8`	6–15 giây.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` hoặc `1:1`. Khi có ảnh, clip lấy theo tỷ lệ của ảnh.
`audio`	boolean	`true`	Được nhận để tương thích. Clip nào cũng có âm thanh: `false` không tạo ra clip không tiếng.
`fallback`	object	không có	`{"enabled": true}` hoặc `{"enabled": false}`. Được nhận để tương thích và bị bỏ qua.

Lược đồ là nghiêm ngặt: trường không xác định bị từ chối chứ không bị bỏ qua. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Ảnh thành video

Truyền một ảnh vào image_urls và mô tả điều xảy ra tiếp theo trong prompt. Clip mở đầu bằng ảnh và giữ nguyên tỷ lệ của ảnh, nên ảnh dọc tạo ra clip dọc bất kể giá trị aspect_ratio.

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

Đầu vào media

Ảnh là URL HTTP(S) công khai. Không chấp nhận data URI base64: hãy tải tệp lên kho lưu trữ của bạn và truyền URL của nó. Dùng ảnh JPG hoặc PNG tối đa 10 MB.

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. Grok Imagine Video 1.5 tính phí theo từng giây video, với mức giá do độ phân giải quyết định:

cost = duration × rate per second for the resolution

Văn bản thành video và ảnh thành video có cùng giá. Độ dài được biết ngay khi yêu cầu được tiếp nhận, nên số tiền tạm giữ chính là số tiền bị tính. Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

Lấy thông tin tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Hãy truy vấn 10–20 giây một lần cho đến khi status là completed hoặc failed. Hết thời gian mạng trong lúc truy vấn không có nghĩa là việc tạo video đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Trong thử nghiệm của chúng tôi, các clip 720p dài 8 giây trả về dạng MP4 (H.264) kèm rãnh âm thanh AAC ở 1280 × 720 cho 16:9, 720 × 1280 cho 9:16 và 720 × 720 cho 1:1, sau khi gửi 111–133 giây. Clip 480p trả về trong 45–84 giây.

Lỗi

Những yêu cầu bị từ chối trước khi tác vụ được tạo sẽ trả về lỗi HTTP kèm đối tượng error và không bị tính phí. Tác vụ thất bại sau khi đã được tiếp nhận sẽ trả về HTTP 200 khi truy vấn, kèm status: "failed" và một đối tượng error.

Hãy xem danh mục lỗi dùng chung để biết mã lỗi, mã trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

Mô tả chủ thể, địa điểm, chuyển động máy quay và ánh sáng, đồng thời nêu âm thanh bạn muốn; âm thanh được tạo cùng hình ảnh.
Làm bản nháp ở 480p, rồi render cảnh quay cuối cùng ở 720p với cùng một yêu cầu.
Để tạo video dọc, gửi aspect_ratio: "9:16" hoặc một ảnh dọc.
Thêm no text, no logos để tránh các dấu hiệu tự bịa ra.