grok-imagine-video
Grok Imagine Video tạo video ngắn từ mô tả văn bản, có thể chọn thời lượng và hình dạng khung. Chính mô hình xAI còn hỗ trợ tạo chuyển động từ ảnh và chỉnh sửa video theo chỉ dẫn.
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ừ mô tả đến video
Grok Imagine Video tạo video từ văn bản. Chính mô hình xAI còn có chế độ dùng ảnh và video nguồn. Trong phương thức tạo video Ailoot đã công bố, đầu vào là mô tả văn bản và kết quả là video.
Quá trình tạo diễn ra bất đồng bộ: trước tiên tạo tác vụ, rồi dùng mã định danh để nhận trạng thái và kết quả hoàn chỉnh. Theo xAI, tạo video có thể mất nhiều phút; thời gian phụ thuộc vào độ phức tạp cảnh, thời lượng, độ phân giải và chế độ đã chọn.
Thời lượng và khung hình
Thời lượng tạo video cho phép từ 1 đến 15 giây. Các định dạng khung gồm 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 và 2:3; mặc định là 16:9. Phiên bản này có 480p và 720p, còn 1080p thuộc phiên bản 1.5.
Tạo chuyển động từ ảnh nguồn
Trong chế độ ảnh của xAI, ảnh trở thành khung hình mở đầu, còn chỉ dẫn văn bản đặt chuyển động. Mặc định hình dạng video theo tỷ lệ ảnh nguồn. Đặt tỷ lệ khung hình tường minh sẽ thay đổi hình dạng và có thể kéo giãn ảnh.
Chỉnh sửa theo chỉ dẫn
Khi xử lý video có sẵn, mô hình áp dụng thay đổi được mô tả và giữ phần còn lại của cảnh. Chế độ giúp thay đổi thành phần cần thiết trong khi giữ cách dàn dựng video gốc. Thời lượng và tỷ lệ kế thừa từ bản gốc; không đặt thời lượng hay hình dạng khung mới.
Video nguồn để chỉnh sửa giới hạn 8,7 giây, kết quả có độ phân giải không cao hơn 720p. Tư liệu 1080p được giảm xuống 720p. Cài đặt tạo video từ văn bản không tự động áp dụng cho chỉnh sửa.
Tiếp tục video có sẵn
Trong chế độ riêng của xAI, phiên bản này tiếp tục video nguồn từ khung hình cuối. MP4 nguồn phải dài từ 2 đến 15 giây; phần thêm từ 2 đến 10 giây, mặc định 6. Kết quả kết hợp video nguồn và phần tiếp. Tỷ lệ, độ phân giải kế thừa từ nguồn với giới hạn 720p; không thể đổi riêng trong chế độ này. Khả năng của nhà sản xuất này khác với phương thức Ailoot đã công bố để tạo từ văn bản.
Ảnh tham chiếu và giới hạn phiên bản
xAI hỗ trợ sử dụng ảnh tham chiếu làm đầu vào để định hướng diện mạo người, quần áo và đồ vật trong cảnh. Ảnh tham chiếu đặt đặc điểm hình ảnh, không đặt chính xác khung hình đầu tiên. Với Grok Imagine Video nguyên bản, không thể kết hợp khung hình mở đầu và ảnh tham chiếu.
Phiên bản này không nhận cố định chính xác khung hình cuối hoặc các khung hình chính trung gian. Những khả năng đó thuộc Grok Imagine Video 1.5. Tạo video, tạo chuyển động từ ảnh nguồn và thay đổi video có sẵn là các chế độ khác nhau; phương thức Ailoot công bố ở đây mô tả tạo từ văn bản.
Ailoot · Tạo video POST /v1/videos/generations grok-imagine-video
grok-imagine-videoBắt đầu
Grok Imagine Video tạo video ngắn từ mô tả văn bản, có thể chọn thời lượng và hình dạng khung. Chính mô hình xAI còn hỗ trợ tạo chuyển động từ ảnh và chỉnh sửa video theo chỉ dẫn.
- Đầ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 | 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 | 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,002 US$ mỗi ảnh đầu vào
- Đầu vào
- 0,01 US$ mỗi giây video đầu vào
- Đầu ra
- 0,05 US$ mỗi giây ở 480p
- Đầu ra
- 0,07 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", "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
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
- Có những đầu vào và kết quả nào?
POST /v1/videos/generations·grok-imagine-video:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos/generations·grok-imagine-video: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:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15