Runway menambahkan Eleven v4 ke API pengembangnya pada 30 September. Catatan rilis mengidentifikasi model sebagai eleven_v4, membatasi skrip hingga 2.500 karakter, dan menyebut tarif kredit akan naik pada 12 Oktober 2026 waktu Pasifik. Bagi pengembang yang menambahkan pembuatan ucapan ke alur kerja produksi, pertanyaan praktisnya adalah apa yang diperlukan untuk permintaan yang valid dan berapa nilai tarif terdokumentasi dalam dolar. Panduan ini didasarkan pada dokumentasi Runway yang diperiksa pada 6 Oktober; BIG CHANGE tidak melakukan panggilan API berbayar atau menilai audionya.

Perubahan utama

  • Apa yang berubah:Runway kini mencantumkan Eleven v4 sebagai model text-to-speech di balik API tugasnya yang sudah ada. Skrip dapat menyertakan tag audio terdokumentasi seperti [laughs] , [whispers] dan [pause] , selama tidak melewati batas 2.500 karakter.
  • Mengapa ini penting:Tim dengan proyek pengembang Runway dapat meminta ucapan menggunakan suara prasetel dan mengambil URL audio dari tugas yang selesai. Integrasi dan perencanaan anggaran dapat menggunakan format permintaan terdokumentasi dan jadwal harga bertanggal.
  • Yang perlu dipantau:Runway mengatakan tarif akan berubah dari 2,2 menjadi 5 kredit per 1.000 karakter pada 12 Oktober 2026 waktu Pasifik. Perkiraan pembuatan berulang perlu memakai tarif yang berlaku saat permintaan ditagih dan memeriksa harga terkini sebelum menetapkan anggaran.

Siapkan proyek dan kunci

Panduan penyiapan Runway menyarankan membuat akun dan proyek di portal pengembang, lalu membuat kunci API proyek pada API Keys. Peran Admin atau Developer diperlukan untuk membuat atau menonaktifkan kunci. Kunci hanya muncul sekali dalam teks biasa, jadi simpan dengan aman. Untuk memakai SDK, Runway menyarankan mengatur RUNWAYML_API_SECRET; SDK membaca variabel tersebut secara otomatis. Jangan taruh rahasia di kode sumber.

Proyek juga memerlukan kredit sebelum dapat memakai API. Runway menyebut pembayaran awal minimum sebesar $10, dengan tarif $0,01 per kredit, melalui tab penagihan proyek. Peran Admin atau Billing admin diperlukan untuk menambahkan kredit. Ini pembelian kredit minimum, bukan biaya satu permintaan ucapan. Halaman penyiapan tidak menyebut adanya panggilan pertama gratis.

Kirim permintaan text-to-speech

Jenis permintaan terkini pada SDK Python Runway memerlukan model, prompt_text dan objek voice untuk Eleven v4. Pada wire, kolom JSON yang sesuai adalah model, promptText dan voice, dengan voice.type diatur ke runway-preset dan sebuah objek presetId. Bernard adalah salah satu suara prasetel yang tercantum. Layanan SDK mengirim permintaan ini ke /v1/text_to_speech dan mengembalikan respons tugas baru. Panduan API Runway mendokumentasikan host, bearer key, dan header X-Runway-Version: 2024-11-06 untuk panggilan HTTP langsung.

Ini adalah badan permintaan yang disusun dari dokumentasi, bukan panggilan yang kami jalankan:

JSON
{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

Entri changelog 30 September Runway mencantumkan [laughs], [whispers], dan [pause] sebagai contoh yang didukung serta menyebut Eleven v4 menggunakan suara prasetel Runway yang sama dengan Eleven v3. Tag merupakan bagian dari skrip; sisakan ruang untuknya dalam batas maksimum 2.500 karakter. SDK juga mencantumkan pengaturan suara opsional, bahasa, dan kolom teks yang berdekatan. Skemanya tidak membuktikan bahwa pengaturan apa pun menjamin penyampaian tertentu, dan artikel ini tidak membuat klaim tentang kualitas suara atau latensi.

Respons awal berupa tugas, bukan byte audio. Panduan keluaran Runway menyarankan kueri GET /v1/tasks/:id; tugas yang berhasil berisi array output URL hasil. URL tersebut kedaluwarsa dalam 24–48 jam setelah API diakses, jadi unduh hasilnya ke penyimpanan sendiri alih-alih memakai URL sementara dalam produk. Contoh keluaran umum adalah tugas video; contoh itu menunjukkan struktur respons tugas, sedangkan daftar model mengidentifikasi keluaran Eleven v4 sebagai audio. Kami belum mengamati respons Eleven v4 atau memverifikasi format berkas audionya.

Hitung harga berdasarkan tanggal

Runway Halaman harga dan catatan rilis mencantumkan 2,2 kredit per 1.000 karakter hingga 12 Oktober 2026 waktu Pasifik, lalu 5 kredit per 1.000 karakter, dengan minimum satu kredit. Pada harga publikasi $0,01 per kredit, tarif itu setara dengan $0,022 dan $0,05 per 1.000 karakter, sebelum pajak yang berlaku. Tarif berikutnya sekitar 2,27 kali tarif sebelumnya.

Contoh perencanaan yang transparan: sepuluh skrip terpisah dengan masing-masing tepat 1.000 karakter yang ditagih berjumlah 10.000 karakter. Mengalikan dengan tarif publikasi menghasilkan 22 kredit, atau $0,22, pada tarif sebelumnya dan 50 kredit, atau $0,50, pada tarif berikutnya. Setiap skrip berada di bawah batas 2.500 karakter, dan setiap permintaan yang dihitung melampaui minimum satu kredit. Ini perhitungan dari tarif yang dicantumkan Runway, bukan tagihan yang diamati. Halaman yang dikutip tidak menjelaskan cara tag dihitung sebagai karakter yang ditagih atau apakah biaya pecahan per permintaan dibulatkan, jadi perkiraan produksi perlu memeriksa catatan penggunaan aktual dan ketentuan terkini.

Sumber dan bacaan lanjutan

Dokumen Changelog API Runway 30 September menetapkan tanggal rilis, ID model, contoh tag, batas skrip, dan pernyataan harga bertanggal. Panduan penyiapan menjelaskan prasyarat proyek, kunci, dan kredit, termasuk izin peran dan pembayaran awal $10. Halaman harga menyediakan konversi kredit ke dolar dan tarif Eleven v4 yang tercantum.

Dokumen skema permintaan Python SDK dan implementasi layanannya menetapkan nama kolom, bentuk suara prasetel, path endpoint, dan respons pembuatan tugas yang diperiksa untuk panduan ini. Panduan memulai, daftar model dan panduan keluaran Runway menyediakan header versi HTTP, klasifikasi keluaran audio, dan perilaku pengambilan tugas. Ini dokumen penyedia, bukan uji kinerja independen. Diperiksa pada 6 Oktober 2026.