API Sora — text-to-video dalam alur yang kompatibel dengan OpenAI

Sora adalah model teks-ke-video milik OpenAI, dan “API Sora” adalah cara bagi tim untuk menghasilkan video secara terprogram, bukan melalui aplikasi konsumen. Di Kunavo saat ini, pembuatan video dari teks berjalan pada Google Veo 3 melalui satu endpoint video bergaya OpenAI — akses ke Sora ada dalam roadmap, dan karena endpoint tersebut tidak bergantung pada model, migrasi ke Sora nanti hanya memerlukan perubahan satu kata. Panduan ini menunjukkan alur kerja dengan Veo 3 agar setiap contoh dapat langsung digunakan sekarang.

Apa itu API Sora?

Sora (Sora 2 dan Sora 2 Pro) mengubah prompt teks — atau gambar statis — menjadi klip video pendek, dengan audio tersinkronisasi pada Sora 2. Bentuk API memungkinkan Anda mengatur pembuatan dalam pipeline: pengambilan gambar pemasaran, animasi produk, b-roll, dan pratinjau storyboard. Formatnya sama pada model video modern: Anda mengirim prompt dan parameter, lalu menerima URL video yang di-host.

Video di Kunavo saat ini: Veo 3

Kunavo menyediakan pembuatan video melalui satu endpoint bergaya OpenAI, /v1/video/generations. Sora belum diaktifkan dalam katalog; model teks-ke-video yang tersedia saat ini adalah Google Veo 3, yang menghasilkan klip sinematik dengan audio bawaan. Contoh di bawah menggunakan veo-3 — ketika Sora hadir, satu-satunya perubahan adalah field model.

Quickstart teks-ke-video

POST menggunakan kunci Kunavo Anda. Pembuatan dapat memerlukan waktu beberapa menit, sehingga panggilan sinkron mempertahankan koneksi tetap terbuka hingga klip siap:

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "um dolly-in cinematográfico em um origami de garça vermelha se abrindo, luz suave",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # a geração pode levar minutos
)
print(resp.json()["data"][0]["url"])

duration (dalam detik) menentukan durasi klip pada model dengan penagihan per detik: model-model Seedance dan model Wan 2.7. Model-model Veo mengabaikannya; setiap klip Veo berdurasi 8 detik dan ditagih per video.

Gambar-ke-video

Untuk menganimasikan gambar statis, berikan image_url (URL https atau file yang diunggah ke /v1/files) bersama prompt. Untuk gerakan yang terkontrol, Anda dapat memberikan frame pertama dan terakhir dengan image_urls dan image_mode: "frame". Contoh lengkap tersedia dalam dokumentasi video.

Siklus hidup tugas asinkron

Dalam produksi, jangan menahan koneksi selama 10 menit. Kirim tugas ke /v1/videos, segera terima ID tugas, lalu lakukan polling di GET /v1/videos/{id} hingga selesai. URL hasil bersifat permanen.

# Produção: envie uma tarefa e faça polling — sem conexão de longa duração.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "meu-uuid-de-tarefa",   # seguro para retry em ~24h
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# depois faça polling em GET /v1/videos/{task["id"]} até concluir

Dokumentasi video mencakup seluruh loop polling, kunci idempotensi, dan pengiriman melalui webhook.

Harga

Veo 3 ditagihkan per video (per klip 8 detik dalam 720p, seperti yang ditampilkan di sini), sekitar 50–70% di bawah harga daftar Google. Resolusi yang lebih tinggi dikenai biaya lebih besar — lihat halaman harga untuk tabel lengkap semua rentang.

Tips prompt video

• Jelaskan adegannya, bukan hanya subjeknya. Gerakan kamera (dolly, pan, push-in), karakteristik lensa, pencahayaan, dan tempo lebih penting daripada kata sifat.
• Tentukan rasio aspek secara eksplisit — 16:9 untuk lanskap, 9:16 untuk vertikal/media sosial.
• Setiap klip Veo berdurasi 8 detik. Rancang setiap pengambilan gambar untuk durasi itu, dan gabungkan beberapa hasil untuk urutan yang lebih panjang.
• Gunakan frame referensi (gambar-ke-video) jika Anda memerlukan karakter atau produk tertentu agar tetap konsisten.

Pertanyaan umum