grok-imagine-video-1.5-preview
Grok Imagine Video 1.5 tạo video từ văn bản dài 1–15 giây, gồm cả 1080p. Chính mô hình hỗ trợ tạo chuyển động từ ảnh, ảnh tham chiếu, đặt khung hình chính và âm thanh đi kèm.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Tạo cảnh video
Grok Imagine Video 1.5 là mô hình của xAI để tạo video từ mô tả văn bản và tư liệu hình ảnh. Phương thức Ailoot hiện tại công bố tạo từ văn bản; những chế độ bổ sung của chính mô hình cho phép tạo chuyển động từ ảnh, dùng ảnh tham chiếu và đặt khung hình mốc của cảnh.
Kết quả được tạo bất đồng bộ: sau khi đặt tác vụ, trạng thái sẵn sàng được kiểm tra bằng mã định danh. Theo xAI, quá trình có thể mất nhiều phút tùy độ phức tạp cảnh, thời lượng và độ phân giải. Nhận mã tác vụ chưa có nghĩa video đã hoàn thành.
Thời lượng, tỷ lệ và độ phân giải
Video được tạo dài từ 1 đến 15 giây. Có thể chọn 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 hoặc 2:3; với văn bản, mặc định là 16:9. Khi tạo chuyển động từ ảnh, mặc định giữ tỷ lệ ảnh.
Tạo từ văn bản và ảnh mở đầu có 480p, 720p và 1080p. Mặc định dùng 480p; chế độ ảnh tham chiếu giới hạn 720p. Không thể áp dụng 1080p cho mọi chế độ chỉ vì mô hình có độ phân giải đó.
Điều khiển diện mạo
Trong chế độ ảnh tham chiếu, xAI nhận tối đa 7 ảnh. Chúng xác định người, đồ vật, quần áo và các đặc điểm hình ảnh khác, không cố định khung hình mở đầu. Cách này dành cho cảnh có nhân vật lặp lại, trình diễn sản phẩm và giữ diện mạo mong muốn giữa những cách dàn dựng.
Khung hình đầu, cuối và trung gian
Phiên bản 1.5 cho phép cố định chính xác khung đầu, khung cuối hoặc cả hai. Nếu chỉ đặt khung cuối, mô hình tự xây dựng mở đầu và đi đến ảnh đã chỉ định. Với hai ranh giới đã đặt, mô hình tạo chuyển động giữa chúng; chỉ dẫn văn bản có thể làm rõ chuyển động và cách máy quay hoạt động.
Để phân cảnh bên trong video, có thể cố định tối đa 4 khung hình chính. Thời điểm mỗi khung phải nằm hẳn sau bắt đầu và trước kết thúc; khớp theo lưới 1/3 giây. Hai khung làm tròn về cùng mốc lưới bị từ chối. Để tránh điều đó, giữ khoảng cách tối thiểu 1/3 giây. Khung đầu và cuối được đặt riêng với bốn khung trung gian này.
Khung hình mốc có thể kết hợp với ảnh tham chiếu và giọng đặt sẵn. Nếu có ít nhất một khung được cố định, mô tả văn bản là tùy chọn: chính chuỗi ảnh xác định cảnh. Không thể dùng khung hình chính cùng chế độ chỉnh sửa video. Những khả năng của xAI không có nghĩa chúng sẵn có trong phương thức Ailoot đã công bố để tạo từ văn bản.
Âm thanh và giọng
Video được tạo mặc định có âm thanh đi kèm; cũng có thể nhận kết quả không tiếng. Trong chế độ tham chiếu giọng của xAI, có thể chọn tối đa 3 giọng đặt sẵn và gắn với những người nói trong cảnh.
Truyền tệp âm thanh riêng làm mẫu giọng không phải khả năng chung của mô hình này: xAI cung cấp riêng theo yêu cầu. Giọng đặt sẵn và âm thanh tải lên là hai loại đầu vào khác nhau.
Các chế độ làm việc
Tạo từ văn bản xây dựng cảnh mới; ảnh mở đầu đặt điểm bắt đầu; ảnh tham chiếu định hướng diện mạo; khung cố định xác định mốc hình ảnh theo thời gian. Mỗi chế độ có giới hạn riêng, nên không thể vô điều kiện chuyển cài đặt từ cách này sang cách khác.
Ailoot · Tạo video POST /v1/videos/generations grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview
grok-imagine-video-1.5-previewBắt đầu
Grok Imagine Video 1.5 tạo video từ văn bản dài 1–15 giây, gồm cả 1080p. Chính mô hình hỗ trợ tạo chuyển động từ ảnh, ảnh tham chiếu, đặt khung hình chính và âm thanh đi kèm.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Video
Có trên Ailoot · đầu vào & phương thức
Ailoot · Tạo video POST /v1/videos/generations
- Đầu vào
text- Đầu ra
video- Định dạng đầu ra
- mp4
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn grok-imagine-video-1.5-preview | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 15 Điều kiện: Không cung cấp đồng thời duration và seconds Đơn vị: giây | Mặc định1 |
Trườngseconds | Loạiinteger|integer_string | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 15 Phương án thay thế: duration | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 480p, 720p, 1080p | Mặc định480p |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Điều kiện: Nếu cung cấp ảnh đầu vào và bỏ tỷ lệ, nhà cung cấp dùng tỷ lệ khung hình của ảnh | Mặc định16:9 |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1280x720, 720x1280, 1920x1080, 1080x1920 Điều kiện: Phải khớp với resolution/aspect_ratio nếu cả hai được chỉ định | Mặc định— |
Trườngimage | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Ảnh đầu vào thực tế được hỗ trợ; cho phép bỏ câu lệnh | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Bắt buộc: prompt
Ảnh thành video · Bắt buộc: image
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốmaterial_types | Hợp đồngtext |
Tham sốrequired | Hợp đồngnull |
Tham sốoptional_controls | Hợp đồngnull |
Vòng đời: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Cấu trúc phương thức và ID là chính xác; khả năng của nhà cung cấp tách biệt với việc cho phép tiếp nhận yêu cầu.
Bảng giá
Mức phí phương thức Ailoot
POST /v1/videos/generations- Đầu vào
- 0,01 US$ mỗi ảnh đầu vào
- Đầu ra
- 0,25 US$ mỗi giây ở 1080p
- Đầu ra
- 0,08 US$ mỗi giây ở 480p
- Đầu ra
- 0,14 US$ mỗi giây ở 720p
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot · Tạo video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'Nhận và lưu kết quả
Ailoot · Tạo video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kiểm tra trạng thái tác vụ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Lưu tất cả kết quả đã hoàn tất
Lưu mọi video đã hoàn tất hoặc tệp trả về; truy xuất từng URL tài nguyên thực tế được trả về.
Giữ lại toàn bộ JSON trạng thái và request_id thực tế. Phản hồi hoàn tất có status=done chứa video.url với URL nội dung thuộc quyền sở hữu. Giữ nguyên thời lượng được báo cáo và mọi trường kết quả được trả về.
Nếu cần kiểm tra phản hồi gốc
Đọc tác vụ gốc hiện có; tuyệt đối không gửi lại lần gửi chưa rõ kết quả.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngrequest_id | Loạistring |
Trườngid | Loạistring |
Trườngstatus | Loạistring |
Trườngvideo.url | Loạiowned signed content URL |
Trườngvideo.duration | Loạinumber |
Trườngvideo.respect_moderation | Loạiboolean |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung kết quả ban đầu chưa có sẵn | Bước tiếp theoThăm dò ID ban đầu được trả về và tuân thủ Retry-After. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Bí danh
Bí danh mô hình
Ailoot grok-imagine-video-1.5-preview
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · grok-imagine-video-1.5-preview
- Có những đầu vào và kết quả nào?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Áp dụng những giới hạn nào?
POST /v1/videos/generations·grok-imagine-video-1.5-preview:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15