Spesifikasi Teknis runwayml-image-to-video
| Spesifikasi | Rincian |
|---|---|
| ID Model | runwayml-image-to-video |
| Penyedia | Runway |
| Kemampuan utama | Menghasilkan video dari gambar awal menggunakan prompt teks dan generasi gerak berbasis kondisi gambar. |
| Jenis tugas API | Tugas generasi gambar ke video asinkron yang dimulai melalui endpoint gambar ke video milik Runway. |
| Model dasar yang didukung di Runway API | Endpoint gambar ke video Runway menerima beberapa model video, termasuk gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, dan veo3. |
| Input yang diperlukan | Gambar input ditambah parameter generasi spesifik model; teks prompt umumnya digunakan untuk menggambarkan gerakan yang diinginkan dan perilaku adegan. |
| Autentikasi | Kunci API Bearer di header Authorization. |
| Header versi | Referensi API Runway memerlukan header X-Runway-Version, dengan nilai terdokumentasi 2024-11-06 untuk endpoint gambar ke video. |
| Format keluaran | Aset video yang dihasilkan dikembalikan melalui pemrosesan API berbasis tugas. |
| Frame rate tipikal | Dokumentasi Runway mencantumkan 24 fps untuk keluaran gambar ke video Gen-3 Alpha. |
| Resolusi keluaran umum | Runway mendokumentasikan 1280×768 untuk Gen-3 Alpha dan 1280×768 serta 768×1280 untuk Gen-3 Alpha Turbo, tergantung orientasi. |
| Panduan input gambar | Runway merekomendasikan untuk menghindari gambar referensi yang lebih kecil dari 640×640 px atau lebih besar dari 4K untuk input gambar. |
| Pola penggunaan di CometAPI | Diakses melalui CometAPI menggunakan pengenal model platform runwayml-image-to-video. |
Apa itu runwayml-image-to-video?
runwayml-image-to-video adalah pengenal model CometAPI untuk mengakses kemampuan generasi gambar ke video milik Runway. Secara praktik, kategori model ini mengambil gambar diam sebagai titik awal visual dan mengubahnya menjadi video yang dihasilkan, biasanya dipandu oleh teks prompt yang menjelaskan gerakan, perilaku kamera, suasana, atau evolusi adegan.
Runway memposisikan gambar ke video sebagai bagian dari tumpukan generasi video yang lebih luas. Dokumentasinya untuk Gen-3 Alpha menggambarkan gambar ke video sebagai cara untuk menganimasikan gambar yang disuplai, dengan penulisan prompt yang berfokus terutama pada pergerakan alih-alih mendeskripsikan kembali semua yang sudah terlihat di dalam frame.
Dari perspektif API, Runway mengekspos generasi gambar ke video sebagai endpoint pembuatan tugas, yang berarti permintaan biasanya memulai job terlebih dahulu dan kemudian memerlukan langkah polling atau pengambilan untuk memperoleh hasil video akhir setelah pemrosesan selesai.
Fitur utama runwayml-image-to-video
- Generasi video berbasis kondisi gambar: Memulai dari gambar diam dan menghasilkan keluaran video yang digerakkan oleh gerak alih-alih membuat video dari teks saja.
- Kontrol gerak yang dipandu prompt: Bekerja paling baik ketika prompt menggambarkan gerakan, pergerakan kamera, dan perubahan adegan untuk menganimasikan frame yang disuplai secara koheren.
- Alur kerja tugas asinkron: Menggunakan permintaan mulai generasi diikuti oleh pengambilan hasil, yang sesuai untuk sistem produksi yang mengantrikan dan memantau job media jangka panjang.
- Beragam opsi model dasar: Endpoint gambar ke video Runway mendukung beberapa model video backend, memberi pengembang fleksibilitas terkait profil kualitas, kecepatan, dan biaya.
- Autentikasi API bergaya produksi: Menggunakan autentikasi token Bearer standar dan header versi API eksplisit untuk integrasi yang terkontrol.
- Dukungan keluaran potret dan lanskap: Runway mendokumentasikan ukuran keluaran untuk mode horizontal dan vertikal di keluarga model yang didukung.
- Kompatibel dengan alur referensi gambar: API dirancang di sekitar referensi gambar, dan Runway menyediakan rekomendasi ukuran input untuk membantu menjaga kualitas generasi.
- Cocok untuk pipeline kreatif yang dapat diperluas: Platform Runway yang lebih luas mencakup alur kerja generasi video terkait seperti keyframe, perluasan, dan mode generasi lainnya, menjadikan gambar ke video berguna sebagai salah satu tahap dalam pipeline kreatif yang lebih besar.
Cara mengakses dan mengintegrasikan runwayml-image-to-video
Langkah 1: Daftar untuk Kunci API
Untuk memulai, daftar di CometAPI dan buat kunci API dari dasbor. Setelah Anda memiliki kunci API, simpan dengan aman dan gunakan di header Authorization untuk semua permintaan.
Langkah 2: Kirim Permintaan ke API runwayml-image-to-video
Gunakan format API resmi Runway melalui CometAPI. Endpoint-nya adalah POST /runwayml/v1/image_to_video. Sertakan 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."
}'
Langkah 3: Ambil dan Verifikasi Hasil
API mengembalikan objek tugas dengan ID tugas. Lakukan polling GET /runwayml/v1/tasks/{task_id} untuk memeriksa status generasi, lalu ambil URL keluaran dari respons tugas yang telah selesai.