Spesifikasi Teknis dari runway-video
| Spesifikasi | Rincian |
|---|---|
| ID Model | runway-video |
| Penyedia | Runway |
| Jenis model | Generasi video AI |
| Modalitas utama | Teks-ke-video dan gambar-ke-video, tergantung pada model Runway yang dipilih |
| Masukan | Prompt teks, gambar referensi, dan dalam beberapa kasus aset media yang diunggah |
| Keluaran | Klip video yang dihasilkan |
| Pola API | Alur kerja pembuatan berbasis tugas yang asinkron |
| Autentikasi | Autentikasi kunci API Bearer |
| Header versi yang diperlukan | X-Runway-Version: 2024-11-06 |
| Host API dasar | api.dev.runwayml.com |
| SDK resmi | SDK Node.js dan Python tersedia |
| Penanganan file | Mendukung unggahan sementara yang mengembalikan nilai runwayUri untuk permintaan generasi |
| Model harga | Penagihan berbasis kredit; model video Runway yang tersedia ditagih per detik output yang dihasilkan |
| Contoh model video yang mendasari | gen4.5, gen4_turbo, gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo |
Apa itu runway-video?
runway-video adalah pengidentifikasi platform CometAPI untuk mengakses kapabilitas pembuatan video Runway melalui API terpadu. Berdasarkan dokumentasi API resmi Runway, Runway menawarkan beberapa model video untuk menghasilkan klip dari prompt teks atau dari gambar, dengan endpoint berbasis tugas untuk memulai pembuatan dan kemudian mengambil hasilnya.
Dalam praktiknya, runway-video paling tepat dipahami sebagai gerbang menuju alur kerja pembuatan video bertenaga Runway daripada nama satu model fondasi yang berdiri sendiri. Katalog API Runway saat ini mencakup beberapa model video dengan mode input dan tingkatan harga berbeda, seperti gen4.5 untuk teks-atau-gambar-ke-video, gen4_turbo untuk gambar-ke-video, serta opsi tambahan seperti gen4_aleph, veo3, veo3.1, veo3.1_fast, dan gen3a_turbo.
Hal ini menjadikan runway-video cocok untuk aplikasi seperti pembuatan prototipe kreatif, generasi konten pemasaran, produksi klip media sosial, visualisasi konsep, dan pengalaman produk yang memerlukan sintesis video format pendek otomatis. Karena API Runway yang mendasarinya menggunakan pekerjaan asinkron, integrasi biasanya mengirimkan permintaan pembuatan terlebih dahulu lalu melakukan polling atau mengambil keluaran tugas setelah pemrosesan selesai.
Fitur utama dari runway-video
- Pembuatan teks-ke-video: Runway mendukung pembuatan video dari prompt bahasa alami pada model yang didukung, memungkinkan pengembang menghasilkan klip langsung dari deskripsi teks.
- Alur kerja gambar-ke-video: Beberapa model video Runway menerima input gambar, menjadikan
runway-videoberguna untuk menganimasikan gambar diam atau membangun pipeline pembuatan video berbasis referensi. - Beragam opsi model dasar: API Runway mengekspos beberapa model video dengan kemampuan dan profil biaya berbeda, memberi fleksibilitas bagi pengembang untuk mengoptimalkan kualitas, kecepatan, atau anggaran.
- Pemrosesan tugas asinkron: Permintaan pembuatan membuat tugas alih-alih langsung mengembalikan media final, yang cocok untuk sistem produksi yang memerlukan antrian, percobaan ulang, dan pemeriksaan status.
- Unggahan aset sementara: Runway menyediakan endpoint unggah yang mengembalikan referensi
runwayUri, mempermudah pengiriman gambar, video, atau audio ke dalam permintaan pembuatan berikutnya. - Dukungan SDK resmi: Runway menawarkan SDK Node.js dan Python, yang dapat menyederhanakan autentikasi, konstruksi permintaan, dan pengambilan keluaran.
- Integrasi API ber-versi: Permintaan memerlukan header
X-Runway-Versioneksplisit, yang membantu pengembang membangun terhadap kontrak API yang diketahui. - Harga berbasis kredit: Runway menagih pembuatan video berdasarkan kredit per detik, dengan harga bervariasi sesuai model yang dipilih.
Cara mengakses dan mengintegrasikan runway-video
Langkah 1: Daftar untuk Kunci API
Untuk mengakses runway-video, pertama buat akun dan hasilkan kunci API melalui dasbor CometAPI Anda. Setelah masuk, salin kunci API Anda dan simpan dengan aman di variabel lingkungan atau pengelola rahasia untuk penggunaan produksi.
Langkah 2: Kirim Permintaan ke API runway-video
Gunakan kunci API Anda untuk mengautentikasi permintaan ke endpoint CometAPI untuk runway-video. Sertakan prompt Anda dan parameter input yang didukung dalam body permintaan, dan tentukan model sebagai 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."
}'
Langkah 3: Mengambil dan Memverifikasi Hasil
Setelah pengiriman, periksa respons API untuk keluaran yang dihasilkan, pengenal tugas, atau payload hasil yang dikembalikan untuk runway-video. Jika proses pembuatan berjalan secara asinkron, lakukan polling ke endpoint CometAPI yang relevan hingga pemrosesan selesai, lalu validasi URL video yang dikembalikan, metadata, dan kontennya sebelum digunakan dalam aplikasi Anda.