Thông số kỹ thuật của runwayml-image-to-video
| Thông số | Chi tiết |
|---|---|
| ID mô hình | runwayml-image-to-video |
| Nhà cung cấp | Runway |
| Khả năng chính | Tạo video từ một ảnh ban đầu bằng cách sử dụng prompt văn bản và sinh chuyển động có điều kiện theo ảnh. |
| Loại tác vụ API | Tác vụ sinh image-to-video bất đồng bộ được khởi tạo qua endpoint image-to-video của Runway. |
| Các mô hình nền tảng được hỗ trợ trong Runway API | Endpoint image-to-video của Runway chấp nhận nhiều mô hình video, bao gồm gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast và veo3. |
| Đầu vào bắt buộc | Một ảnh đầu vào cùng các tham số sinh tùy theo mô hình; prompt văn bản thường được dùng để mô tả chuyển động và hành vi của cảnh. |
| Xác thực | Khóa API Bearer trong header Authorization. |
| Header phiên bản | Tài liệu API của Runway yêu cầu header X-Runway-Version, với giá trị được ghi là 2024-11-06 cho endpoint image-to-video. |
| Định dạng đầu ra | Tài sản video được tạo trả về thông qua xử lý API theo tác vụ. |
| Tốc độ khung hình điển hình | Tài liệu Runway liệt kê 24 fps cho đầu ra image-to-video của Gen-3 Alpha. |
| Độ phân giải đầu ra phổ biến | Runway ghi nhận 1280×768 cho Gen-3 Alpha và 1280×768 cũng như 768×1280 cho Gen-3 Alpha Turbo, tùy theo hướng khung hình. |
| Hướng dẫn về ảnh đầu vào | Runway khuyến nghị tránh ảnh tham chiếu nhỏ hơn 640×640 px hoặc lớn hơn 4K cho ảnh đầu vào. |
| Cách sử dụng trên CometAPI | Truy cập thông qua CometAPI bằng định danh mô hình nền tảng runwayml-image-to-video. |
runwayml-image-to-video là gì?
runwayml-image-to-video là định danh mô hình của CometAPI để truy cập khả năng sinh video từ ảnh của Runway. Trong thực tế, nhóm mô hình này lấy một ảnh tĩnh làm điểm xuất phát trực quan và biến nó thành video được tạo, thường được dẫn dắt bởi prompt văn bản mô tả chuyển động, chuyển động máy quay, bầu không khí hoặc diễn tiến của cảnh.
Runway định vị image-to-video như một phần trong ngăn xếp tạo video rộng hơn của mình. Tài liệu cho Gen-3 Alpha mô tả image-to-video như một cách để “làm sống” ảnh đã cung cấp, với prompt tập trung đặc biệt vào chuyển động thay vì mô tả lại mọi thứ đã hiện hữu trong khung hình.
Từ góc độ API, Runway cung cấp sinh image-to-video dưới dạng endpoint tạo tác vụ, nghĩa là yêu cầu thường khởi tạo một job trước rồi cần thăm dò (poll) hoặc các bước truy xuất để lấy về kết quả video cuối cùng sau khi xử lý hoàn tất.
Tính năng chính của runwayml-image-to-video
- Tạo video có điều kiện theo ảnh: Bắt đầu từ ảnh tĩnh và tạo ra đầu ra video dựa trên chuyển động, thay vì chỉ tạo video từ văn bản.
- Kiểm soát chuyển động do prompt dẫn dắt: Hoạt động tốt nhất khi prompt mô tả chuyển động, chuyển động máy quay và thay đổi cảnh để làm sinh động khung hình đã cung cấp một cách mạch lạc.
- Luồng công việc tác vụ bất đồng bộ: Sử dụng yêu cầu khởi tạo sinh rồi truy xuất kết quả, phù hợp với hệ thống sản xuất xếp hàng và giám sát các job media chạy lâu.
- Nhiều tùy chọn mô hình nền tảng: Endpoint image-to-video của Runway hỗ trợ nhiều mô hình video backend, giúp nhà phát triển linh hoạt giữa chất lượng, tốc độ và chi phí.
- Xác thực API theo chuẩn production: Dùng xác thực Bearer-token và header phiên bản rõ ràng để tích hợp có kiểm soát.
- Hỗ trợ đầu ra dọc và ngang: Runway cung cấp kích thước đầu ra cho cả chế độ ngang và dọc trong các họ mô hình được hỗ trợ.
- Tương thích quy trình ảnh tham chiếu: API được thiết kế xoay quanh ảnh tham chiếu, và Runway đưa ra khuyến nghị về kích thước ảnh đầu vào để giữ chất lượng sinh.
- Phù hợp pipeline sáng tạo có thể mở rộng: Nền tảng rộng hơn của Runway bao gồm các quy trình tạo video liên quan như keyframe, mở rộng và các chế độ sinh khác, khiến image-to-video hữu ích như một giai đoạn trong pipeline sáng tạo lớn hơn.
Cách truy cập và tích hợp runwayml-image-to-video
Bước 1: Đăng ký lấy khóa API
Bắt đầu bằng cách đăng ký trên CometAPI và tạo khóa API từ bảng điều khiển. Sau khi có khóa API, hãy lưu trữ an toàn và sử dụng trong header Authorization cho mọi yêu cầu.
Bước 2: Gửi yêu cầu đến API runwayml-image-to-video
Sử dụng định dạng API chính thức của Runway qua CometAPI. Endpoint là POST /runwayml/v1/image_to_video. Bao gồm header X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Bước 3: Lấy và xác minh kết quả
API trả về một đối tượng tác vụ với ID tác vụ. Thăm dò GET /runwayml/v1/tasks/{task_id} để kiểm tra trạng thái sinh, sau đó lấy URL đầu ra từ phản hồi khi tác vụ đã hoàn tất.