Konfigurasi Video API Runway
Runway adalah platform pembuatan video. Ini biasanya bukan Base URL untuk diisi di Chatbox. Sebagai gantinya, buat API Key di platform Runway, lalu gunakan SDK resmi atau permintaan HTTP untuk membuat tugas video.
Informasi resmi Unduhan dan dokumentasi mengacu pada situs resmi.
Skenario apa yang cocok
Text-to-VideoImage-to-VideoAsynchronous TasksOfficial SDK
Pahami alur kerja tugas video terlebih dahulu
- Buat API Key dan pastikan akun Anda memiliki izin API video dan saldo yang cukup.
- Pilih jenis tugas: teks-ke-video, gambar-ke-video, atau tugas video lain yang saat ini didukung oleh dokumentasi resmi.
- Anda tidak akan langsung mendapatkan file video setelah mengirimkan tugas; biasanya, Anda akan menerima objek tugas atau ID tugas terlebih dahulu.
- Tunggu hingga tugas selesai, lalu baca alamat output atau unduh hasilnya.
- Jika terjadi kegagalan, periksa status tugas dan detail kesalahan terlebih dahulu, jangan hanya memeriksa Key.
Siapkan parameter
| Item konfigurasi | Metode Pengisian |
|---|---|
| API Key | Dibuat di backend Runway; SDK resmi membaca <code>RUNWAYML_API_SECRET</code> secara default |
| Task | teks-ke-video / gambar-ke-video |
| Prompt | Deskripsi konten video |
| Ratio / Size | Lanskap, potret, atau ukuran tertentu |
| Duration | Durasi Video |
| Status | Lakukan polling tugas hingga selesai |
| Pengaturan | Deskripsi | Tips untuk pemula |
|---|---|---|
| API Key | Kredensial permintaan untuk Runway API | Hanya simpan di variabel lingkungan mesin lokal atau server, menggunakan nama variabel RUNWAYML_API_SECRET |
| Prompt | Deskripsi konten video | Tulis lebih pendek terlebih dahulu, lalu sempurnakan setelah memastikan gayanya |
| Image | Gambar awal untuk gambar-ke-video | Unggah gambar yang jelas dengan subjek yang jelas |
| Duration | Durasi video dalam detik | Uji biaya dan hasilnya terlebih dahulu dengan durasi yang lebih pendek |
| Status | Status Tugas | Pembuatan video bersifat asinkron dan memerlukan waktu tunggu hingga selesai. |
Contoh SDK
Nama variabel lingkungan Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYContoh Tugas 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); } }Bidang-bidang pada platform video akan diperbarui seiring pembaruan versi model. Contoh pada halaman ini digunakan untuk memahami struktur konfigurasi, dan bidang sebenarnya harus merujuk pada versi dokumentasi resmi saat ini.
| Gejala | Pemeriksaan prioritas | Penanganan |
|---|---|---|
| Video tidak langsung dikembalikan setelah pengiriman | Apakah tugas masih dalam antrean atau sedang dibuat? | Pembuatan video adalah tugas asinkron; tunggu hingga statusnya selesai sebelum mengambil hasilnya. |
| Tugas gagal | Nama model, skala, durasi, apakah gambar input memenuhi persyaratan model saat ini | Sesuaikan parameter berdasarkan detail kesalahan yang dikembalikan, dan jangan mengubah terlalu banyak item sekaligus. |
| Biaya lebih tinggi dari yang diharapkan | Durasi, resolusi, versi model | Uji coba terlebih dahulu dengan durasi pendek dan parameter berbiaya rendah, lalu buat secara massal |