runway_video

Thông số kỹ thuật của runway-video

runway-video là gì?

runway-video là định danh nền tảng của CometAPI để truy cập các khả năng tạo video của Runway thông qua một API thống nhất. Dựa trên tài liệu API chính thức của Runway, Runway cung cấp nhiều mô hình video để tạo clip từ prompt văn bản hoặc từ hình ảnh, với các endpoint dựa trên tác vụ để bắt đầu tạo và sau đó truy xuất kết quả.

Trên thực tế, runway-video nên được hiểu là một cổng vào các quy trình tạo video do Runway hỗ trợ thay vì tên của một mô hình nền tảng độc lập duy nhất. Danh mục API hiện tại của Runway bao gồm một số mô hình video với các chế độ đầu vào và mức giá khác nhau, như gen4.5 dành cho văn bản hoặc ảnh thành video, gen4_turbo dành cho ảnh thành video, cùng các tùy chọn bổ sung như gen4_aleph, veo3, veo3.1, veo3.1_fast và gen3a_turbo.

Điều này khiến runway-video phù hợp cho các ứng dụng như thử nghiệm ý tưởng sáng tạo, tạo nội dung tiếp thị, sản xuất clip cho mạng xã hội, trực quan hóa ý tưởng và các trải nghiệm sản phẩm cần tổng hợp video ngắn tự động. Vì API Runway cơ sở sử dụng các tác vụ bất đồng bộ, tích hợp thường gửi yêu cầu tạo trước rồi thăm dò (poll) hoặc lấy kết quả tác vụ sau khi xử lý hoàn tất.

Các tính năng chính của runway-video

• Tạo video từ văn bản: Runway hỗ trợ tạo video từ prompt ngôn ngữ tự nhiên trên các mô hình được hỗ trợ, cho phép nhà phát triển tạo clip trực tiếp từ văn bản mô tả.
• Quy trình ảnh thành video: Nhiều mô hình video của Runway chấp nhận đầu vào là hình ảnh, khiến runway-video hữu ích cho việc tạo chuyển động từ ảnh tĩnh hoặc xây dựng pipeline tạo video dựa trên tham chiếu.
• Nhiều tùy chọn mô hình cơ sở: API của Runway cung cấp nhiều mô hình video với năng lực và chi phí khác nhau, giúp nhà phát triển linh hoạt tối ưu theo chất lượng, tốc độ hoặc ngân sách.
• Xử lý tác vụ bất đồng bộ: Yêu cầu tạo sẽ tạo ra các tác vụ thay vì trả về nội dung cuối ngay lập tức, phù hợp với hệ thống sản xuất cần xếp hàng, thử lại và kiểm tra trạng thái.
• Tải lên tài nguyên tạm thời: Runway cung cấp các endpoint tải lên trả về tham chiếu runwayUri, giúp dễ dàng truyền hình ảnh, video hoặc tài nguyên âm thanh vào các yêu cầu tạo về sau.
• Hỗ trợ SDK chính thức: Runway cung cấp SDK cho Node.js và Python, giúp đơn giản hóa việc xác thực, xây dựng yêu cầu và lấy kết quả.
• Tích hợp API có phiên bản: Các yêu cầu cần header X-Runway-Version rõ ràng, giúp nhà phát triển xây dựng dựa trên một hợp đồng API đã biết.
• Định giá dựa trên tín dụng: Runway tính phí tạo video theo số tín dụng trên mỗi giây, với mức giá thay đổi theo mô hình cơ sở được chọn.

Cách truy cập và tích hợp runway-video

Bước 1: Đăng ký và lấy khóa API

Để truy cập runway-video, trước tiên hãy tạo tài khoản và tạo khóa API qua bảng điều khiển CometAPI của bạn. Sau khi đăng nhập, sao chép khóa API và lưu trữ an toàn trong biến môi trường hoặc trình quản lý bí mật cho môi trường sản xuất.

Bước 2: Gửi yêu cầu tới API runway-video

Sử dụng khóa API của bạn để xác thực các yêu cầu tới endpoint CometAPI dành cho runway-video. Truyền prompt và mọi tham số đầu vào được hỗ trợ trong phần thân yêu cầu, và chỉ định model là runway-video.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

Bước 3: Nhận và xác minh kết quả

Sau khi gửi, kiểm tra phản hồi API để lấy đầu ra được tạo, định danh tác vụ hoặc payload kết quả trả về cho runway-video. Nếu quá trình tạo chạy bất đồng bộ, hãy thăm dò endpoint CometAPI tương ứng cho tới khi xử lý hoàn tất, sau đó xác thực URL video, siêu dữ liệu và nội dung trả về trước khi sử dụng trong ứng dụng của bạn.