Grok Imagine video
Hỗ trợ văn bản, khung đầu và ảnh tham chiếu. Không hỗ trợ video tham chiếu, âm thanh tham chiếu hoặc cặp khung đầu/cuối. Khung đầu và ảnh tham chiếu thông thường có ý nghĩa khác nhau; không chọn chế độ chỉ dựa vào số ảnh.
Mô hình và thông số
| Mô hình | Thời lượng đầu ra | Độ phân giải | Chế độ ảnh tham chiếu |
|---|---|---|---|
grok-imagine-video | 1–15 giây | 480p / 720p | Hiện tối đa 7 ảnh, tối đa 10 giây |
grok-imagine-video-1.5 | 1–15 giây | 480p / 720p / 1080p | Hiện tối đa 7 ảnh, preset tối đa 15 giây |
Tuân theo giới hạn của từng chế độ. “≥7” trong tài liệu nghĩa là mẫu thử hỗ trợ ít nhất bảy ảnh, không phải bắt buộc bảy ảnh hoặc đã công bố trần cứng. PopGo hiện cho phép 1–7 ảnh tham chiếu.
Trường và chế độ
| Trường | Kiểu | Quy tắc |
|---|---|---|
model | string | ID mô hình công khai ở trên, bắt buộc |
prompt | string | Bắt buộc; tối đa 4096 byte UTF-8 |
seconds | integer | Số nguyên trong giới hạn chế độ; giao diện mặc định 8 giây |
resolution | string | Theo mô hình; giao diện mặc định 720p |
aspect_ratio | string | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3; mặc định 16:9; bỏ ở chế độ khung đầu |
input_reference | object | Đúng một khung đầu; đối tượng chứa image_url |
reference_images | object[] | Tham chiếu chủ thể/phong cách; mảng đối tượng có image_url |
Khung đầu đặt điểm bắt đầu của cảnh; ảnh tham chiếu định hướng chủ thể, phong cách và tính nhất quán. Một ảnh vẫn có thể là tham chiếu thông thường. input_reference và reference_images loại trừ nhau. Không dùng image_url ở cấp cao nhất: trường sai có thể bị bỏ qua dù vẫn tạo video và tính phí.
Nguồn, tỷ lệ và prompt
Tài liệu mô tả URL công khai và Data URL đầy đủ, nhưng cũng ghi nhận tải ảnh công khai thất bại sau khi tạo tác vụ. Preset Grok hiện dùng Base64: ảnh cục bộ được mã hóa thành data:image/...;base64,... đầy đủ. Ảnh công khai phải được đọc rồi mã hóa; giới hạn khác nguồn của trình duyệt có thể chặn bước này. Base64 trần, đường dẫn tệp và trang chia sẻ không phải dữ liệu ảnh.
Khung đầu không gửi aspect_ratio. Dịch vụ theo ảnh đầu vào và có thể cắt hoặc đổi kích thước; hãy cắt trước nếu cần bố cục cụ thể. Ảnh tham chiếu vẫn cho chọn tỷ lệ. Không có bảo đảm công khai đầy đủ cho mọi tỷ lệ đầu vào.
4096 là số byte, không phải số ký tự. Mẫu 1365 ký tự tiếng Trung dùng 4095 byte thành công; 1366 ký tự dùng 4098 byte thất bại. Đo UTF-8 cho văn bản hỗn hợp rồi rút gọn prompt.
Ví dụ yêu cầu
Dưới đây là khung đầu và ảnh tham chiếu thông thường. Thay YOUR_IMAGE_DATA_URL bằng Data URL ảnh đầy đủ. Với văn bản thành video, bỏ toàn bộ trường tham chiếu.
{
"model": "YOUR_MODEL",
"prompt": "A person turns naturally toward the camera",
"seconds": 5,
"resolution": "720p",
"input_reference": { "image_url": "YOUR_IMAGE_DATA_URL" }
}
{
"model": "YOUR_MODEL",
"prompt": "Keep the subject and visual style consistent",
"seconds": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_images": [{ "image_url": "YOUR_IMAGE_DATA_URL" }]
}
Trường chưa xác nhận và âm thanh đầu ra
HTTP 200 không chứng minh seed, watermark hoặc trường chưa công bố có hiệu lực. Không thêm tham số preset hiện chưa mở. generate_audio chỉ điều khiển âm thanh đầu ra, không phải tham chiếu âm thanh. Trường lạ không vượt qua giới hạn thời lượng hoặc loại trừ.
Lỗi và cách sửa
| Lỗi hoặc hiện tượng | Hành động |
|---|---|
| reference-to-video duration exceeds 10s | Đặt tối đa 10 giây cho tham chiếu ảnh của bản tiêu chuẩn |
| Prompt length exceeds 4096 | Giảm số byte UTF-8 |
| Duration must be between 1 and 15 seconds | Dùng số nguyên và tuân giới hạn chặt hơn của chế độ |
| Cannot specify both image and reference_images | Chỉ giữ khung đầu hoặc ảnh tham chiếu |
| grok_media_no_eligible_account | Chưa có dung lượng xử lý; thử lại giới hạn và giãn cách, không tạo hàng loạt |
| imagine:content-moderated | Sửa nội dung; có lỗi được ghi nhận vẫn có usage khác 0, hãy xem hóa đơn PopGo |
| Thành công nhưng không theo ảnh | Kiểm tra trường đã gửi, bước tải ảnh và khung hình kết quả; ID không chứng minh ảnh được dùng |
Lưu id rồi thăm dò queued / in_progress / completed / failed. Kiểm tra tác vụ cũ trước khi gửi lại; timeout không chứng minh chưa tạo. Kiểm tra quyền, số dư và dung lượng xử lý riêng. Xem Quy trình tác vụ video.