Spesifikasi Teknikal bagi runwayml-image-to-video
| Spesifikasi | Butiran |
|---|---|
| ID Model | runwayml-image-to-video |
| Penyedia | Runway |
| Keupayaan utama | Menjana video daripada imej permulaan menggunakan prompt teks dan penjanaan gerakan berasaskan imej. |
| Jenis tugas API | Tugas penjanaan imej-ke-video tidak segerak yang dimulakan melalui endpoint image-to-video Runway. |
| Model asas yang disokong dalam Runway API | Endpoint image-to-video Runway menerima pelbagai model video, termasuk gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast, dan veo3. |
| Input yang diperlukan | Satu imej input serta parameter penjanaan khusus model; prompt teks lazimnya digunakan untuk menerangkan gerakan dan tingkah laku adegan yang diingini. |
| Pengesahan | Kunci API Bearer dalam pengepala Authorization. |
| Pengepala versi | Rujukan API Runway memerlukan pengepala X-Runway-Version, dengan nilai yang didokumenkan 2024-11-06 untuk endpoint image-to-video. |
| Format output | Aset video terjana dikembalikan melalui pemprosesan API berasaskan tugas. |
| Kadar bingkai lazim | Dokumentasi Runway menyenaraikan 24 fps untuk output image-to-video Gen-3 Alpha. |
| Resolusi output lazim | Runway mendokumenkan 1280×768 untuk Gen-3 Alpha dan 1280×768 serta 768×1280 untuk Gen-3 Alpha Turbo, bergantung pada orientasi. |
| Panduan input imej | Runway mengesyorkan mengelakkan imej rujukan yang lebih kecil daripada 640×640 px atau lebih besar daripada 4K untuk input imej. |
| Corak penggunaan pada CometAPI | Diakses melalui CometAPI menggunakan pengecam model platform runwayml-image-to-video. |
Apakah runwayml-image-to-video?
runwayml-image-to-video ialah pengecam model CometAPI untuk mengakses keupayaan penjanaan imej-ke-video Runway. Dalam amalan, kategori model ini mengambil satu imej statik sebagai titik permulaan visual dan mengubahnya menjadi video terjana, lazimnya dipandu oleh prompt teks yang menerangkan pergerakan, tingkah laku kamera, suasana, atau evolusi adegan.
Runway meletakkan imej-ke-video sebagai sebahagian daripada timbunan penjanaan video yang lebih luas. Dokumentasinya untuk Gen-3 Alpha menerangkan imej-ke-video sebagai cara untuk menganimasikan imej yang dibekalkan, dengan pemfokusan prompt khusus pada pergerakan dan bukannya menghuraikan semula segala yang sudah kelihatan dalam bingkai.
Dari perspektif API, Runway mendedahkan penjanaan imej-ke-video sebagai endpoint penciptaan tugas, yang bermaksud permintaan lazimnya memulakan kerja terlebih dahulu dan kemudian memerlukan langkah polling atau pengambilan untuk memperoleh hasil video akhir selepas pemprosesan selesai.
Ciri utama runwayml-image-to-video
- Penjanaan video berasaskan imej: Bermula daripada imej statik dan menghasilkan output video yang didorong oleh pergerakan, bukan mencipta video daripada teks semata-mata.
- Kawalan pergerakan dipandu prompt: Berfungsi paling baik apabila prompt menerangkan pergerakan, pergerakan kamera, dan perubahan adegan untuk menganimasikan bingkai yang dibekalkan secara koheren.
- Aliran kerja tugas tak segerak: Menggunakan permintaan memulakan penjanaan diikuti oleh pengambilan hasil, sesuai untuk sistem produksi yang beratur dan memantau tugasan media jangka panjang.
- Pelbagai pilihan model asas: Endpoint API imej-ke-video Runway menyokong beberapa model video backend, memberikan pembangun fleksibiliti dari segi kualiti, kelajuan, dan profil kos.
- Autentikasi API bertaraf produksi: Menggunakan autentikasi token Bearer standard dan pengepala versi yang eksplisit untuk integrasi yang terkawal.
- Sokongan untuk output potret dan landskap: Runway mendokumenkan saiz output untuk mod penjanaan mendatar dan menegak dalam keluarga model yang disokong.
- Keserasian aliran kerja imej rujukan: API direka berasaskan imej rujukan, dan Runway menyediakan saranan saiz input untuk membantu mengekalkan kualiti penjanaan.
- Sesuai untuk rantaian kreatif yang boleh dikembangkan: Platform Runway yang lebih luas merangkumi aliran penjanaan video berkaitan seperti keyframes, peluasan, dan mod lain, menjadikan imej-ke-video berguna sebagai satu peringkat dalam rantaian kreatif yang lebih besar.
Cara mengakses dan mengintegrasikan runwayml-image-to-video
Langkah 1: Daftar untuk Kunci API
Untuk bermula, daftar pada CometAPI dan jana kunci API anda daripada papan pemuka. Selepas mempunyai kunci API, simpan dengan selamat dan gunakan dalam pengepala Authorization untuk semua permintaan.
Langkah 2: Hantar Permintaan ke API runwayml-image-to-video
Gunakan format API rasmi Runway melalui CometAPI. Endpoint ialah POST /runwayml/v1/image_to_video. Sertakan pengepala 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: Dapatkan dan Sahkan Keputusan
API mengembalikan objek tugas dengan ID tugas. Lakukan polling ke GET /runwayml/v1/tasks/{task_id} untuk menyemak status penjanaan, kemudian dapatkan URL output daripada respons tugas yang telah selesai.