Sora API — pembuatan video dengan AI (saat ini menggunakan Veo 3.1)

Sora adalah model teks-ke-video OpenAI, dan “Sora API” adalah cara bagi tim untuk menghasilkan video secara terprogram, bukan melalui aplikasi konsumen. Di Kunavo, konversi teks-ke-video saat ini berjalan dengan Google Veo 3 melalui satu endpoint video bergaya OpenAI—akses Sora ada dalam roadmap, dan karena endpoint ini tidak bergantung pada model, peralihan ke Sora nantinya hanya memerlukan perubahan satu kata. Panduan ini menggunakan Veo 3 agar setiap contoh dapat langsung dijalankan sekarang.

Apa itu Sora API?

Sora (Sora 2 dan Sora 2 Pro) mengubah perintah teks—atau gambar diam—menjadi klip video pendek, dengan audio tersinkronisasi di Sora 2. Format API memungkinkan Anda memasukkan pembuatan ke dalam pipeline: materi pemasaran, animasi produk, b-roll, dan pratinjau draf. Polanya sama pada model video modern: kirim prompt dan parameter, lalu terima 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 aktif di katalog; model teks-ke-video langsungnya adalah Google Veo 3, yang menghasilkan klip sinematik dengan audio bawaan. Contoh di bawah menggunakan veo-3—saat Sora hadir, satu-satunya perubahan adalah bidang model.

Mulai cepat teks-ke-video

Satu POST dengan kunci Kunavo Anda. Pembuatan dapat memerlukan beberapa menit; karena itu, panggilan sinkron mempertahankan koneksi 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": "kırmızı bir origami turnanın açılışına yumuşak ışıkta sinematik dolly-in",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # üretim dakikalar sürebilir
)
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 diam, teruskan image_url bersama prompt (URL https atau file yang Anda unggah ke /v1/files). Anda dapat meneruskan frame pertama dan terakhir dengan image_urls dan image_mode: "frame" untuk gerakan yang terkontrol. Contoh lengkap tersedia di dokumentasi video.

Siklus hidup tugas asinkron

Jangan mempertahankan koneksi selama 10 menit dalam produksi. Kirim tugas ke /v1/videos, segera dapatkan ID tugas, lalu lakukan polling pada GET /v1/videos/{id} hingga selesai. URL hasil bersifat permanen.

# Üretim: bir görev gönderin, sonra yoklayın — uzun ömürlü bağlantı yok.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # ~24s içinde yeniden denemeye güvenli
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# ardından tamamlanana kadar GET /v1/videos/{task["id"]} adresini yoklayın

Dokumentasi video mencakup siklus polling lengkap, kunci idempotensi, dan pengiriman webhook.

Harga

Veo 3 ditagihkan per video (di sini ditampilkan per klip 8 detik 720p) dan harganya sekitar 50-70% di bawah harga resmi Google. Resolusi yang lebih tinggi lebih mahal—lihat halaman harga untuk tabel tingkat lengkap.

Tips prompt untuk video

• Deskripsikan pengambilan gambar, bukan hanya subjeknya. Gerakan kamera (dolly, pan, push-in), karakter lensa, pencahayaan, dan tempo lebih penting daripada kata sifat.
• Tentukan rasio aspek secara eksplisit—16:9 untuk lanskap, 9:16 untuk potret/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 karakter atau produk tertentu harus tetap konsisten.

FAQ