Cấu hình Runway Video API
Runway là một nền tảng tạo video. Đây thường không phải là Base URL để điền vào Chatbox. Thay vào đó, hãy tạo API Key trên nền tảng Runway, sau đó sử dụng SDK chính thức hoặc yêu cầu HTTP để tạo các tác vụ video.
Thông tin chính thức Tải xuống và tài liệu vui lòng tham khảo trang web chính thức.
Phù hợp với các tình huống nào
Văn bản sang videoHình ảnh sang videoTác vụ không đồng bộSDK chính thức
Trước tiên hãy hiểu quy trình tác vụ video
- Tạo API Key và đảm bảo tài khoản của bạn có quyền sử dụng Video API và còn số dư.
- Chọn loại tác vụ: văn bản sang video, hình ảnh sang video hoặc các tác vụ video khác hiện được tài liệu chính thức hỗ trợ.
- Bạn sẽ không nhận được tệp video ngay sau khi gửi tác vụ; thông thường, trước tiên bạn sẽ nhận được một đối tượng tác vụ hoặc ID tác vụ.
- Đợi tác vụ hoàn tất, sau đó đọc địa chỉ đầu ra hoặc tải xuống kết quả.
- Trong trường hợp thất bại, trước tiên hãy kiểm tra trạng thái tác vụ và chi tiết lỗi, đừng chỉ kiểm tra mỗi Key.
Chuẩn bị tham số
| Mục cấu hình | Cách điền |
|---|---|
| API Key | Tạo trong trang quản trị Runway; SDK chính thức mặc định đọc <code>RUNWAYML_API_SECRET</code> |
| Task | text-to-video / image-to-video |
| Prompt | Mô tả nội dung video |
| Ratio / Size | Khổ ngang, khổ dọc hoặc kích thước được chỉ định |
| Duration | Thời lượng video |
| Status | Thăm dò trạng thái tác vụ cho đến khi hoàn tất |
| Cài đặt | Mô tả | Mẹo cho người mới bắt đầu |
|---|---|---|
| API Key | Thông tin xác thực yêu cầu cho Runway API | Chỉ lưu trong biến môi trường của máy cục bộ hoặc máy chủ, sử dụng tên biến RUNWAYML_API_SECRET |
| Prompt | Mô tả nội dung video | Trước tiên hãy viết ngắn gọn, sau khi xác định phong cách thì trau chuốt thêm |
| Image | Hình ảnh bắt đầu cho tác vụ hình ảnh sang video | Tải lên hình ảnh rõ nét với chủ thể rõ ràng |
| Duration | Số giây của video | Trước tiên hãy thử nghiệm chi phí và hiệu ứng với thời lượng ngắn hơn |
| Status | Trạng thái tác vụ | Quá trình tạo video là không đồng bộ và cần phải đợi hoàn tất. |
Ví dụ SDK
Tên biến môi trường Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYVí dụ tác vụ Node.js Runway
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Các trường của nền tảng video sẽ được cập nhật theo phiên bản mô hình. Ví dụ trên trang này nhằm giúp hiểu cấu trúc cấu hình, các trường thực tế vui lòng tham khảo phiên bản hiện tại của tài liệu chính thức.
| Hiện tượng | Ưu tiên kiểm tra | Cách xử lý |
|---|---|---|
| Video không được trả về ngay sau khi gửi | Tác vụ vẫn đang trong hàng đợi hay đang được tạo? | Tạo video là một tác vụ không đồng bộ; hãy đợi cho đến khi trạng thái hoàn tất trước khi lấy kết quả. |
| Tác vụ thất bại | Tên mô hình, tỷ lệ, thời lượng, hình ảnh đầu vào có đáp ứng yêu cầu của mô hình hiện tại hay không | Điều chỉnh các tham số dựa trên chi tiết lỗi được trả về, và không nên thay đổi quá nhiều mục cùng một lúc. |
| Chi phí cao hơn dự kiến | Thời lượng, độ phân giải, phiên bản mô hình | Trước tiên hãy thử nghiệm với thời lượng ngắn và các tham số chi phí thấp, sau đó mới tạo hàng loạt |