Cara menggunakan Sora API — pembuatan video AI yang langsung berjalan (Veo 3.1 / kompatibel dengan OpenAI)

Sora adalah model pembuat video dari teks milik OpenAI, dan “Sora API” adalah cara menghasilkan video secara terprogram alih-alih melalui aplikasi konsumen. Di Kunavo, pembuatan video dari teks saat ini berjalan dengan Google Veo 3 melalui satu endpoint video bergaya OpenAI—dukungan Sora ada dalam peta jalan, dan karena endpoint tidak bergantung pada model, beralih ke Sora nantinya hanya memerlukan perubahan satu kata. Panduan ini menunjukkan alur kerja dengan Veo 3 agar semua contoh dapat langsung dijalankan sekarang.

Apa itu Sora API?

Sora (Sora 2 dan Sora 2 Pro) mengubah prompt teks—atau satu gambar diam—menjadi klip video pendek, dengan audio tersinkronisasi pada Sora 2. Jika digunakan melalui API, pembuatan video dapat diintegrasikan ke dalam pipeline, misalnya untuk video pemasaran, animasi produk, b-roll, dan pratinjau storyboard. Polanya sama di berbagai model video modern: kirim prompt dan parameter, lalu terima URL video yang dihosting.

Video yang saat ini tersedia di Kunavo: Veo 3

Kunavo menyediakan pembuatan video melalui satu endpoint bergaya OpenAI /v1/video/generations. Sora belum diaktifkan dalam katalog; model pembuat video dari teks yang tersedia saat ini adalah Google Veo 3, yang menghasilkan klip sinematik dengan audio bawaan. Contoh berikut menggunakan veo-3—ketika Sora tersedia, hanya kolom model yang perlu diubah.

Mulai cepat teks ke video

Cukup satu permintaan POST dengan kunci Kunavo Anda. Pembuatan video dapat memakan waktu beberapa menit, sehingga 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": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # 生成には数分かかることがあります
)
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, sertakan image_url (URL https atau file yang telah diunggah ke /v1/files) bersama prompt. Untuk mengontrol gerakan, Anda dapat meneruskan frame pertama dan terakhir menggunakan image_urls dan image_mode: "frame". Contoh terperinci tersedia dalam dokumentasi video.

Siklus hidup tugas asinkron

Dalam lingkungan produksi, jangan mempertahankan koneksi selama 10 menit. Mengirim tugas ke /v1/videos akan langsung mengembalikan ID tugas, lalu lakukan polling pada GET /v1/videos/{id} hingga tugas selesai. URL hasil bersifat permanen.

# 本番: タスクを投入してからポーリング——長時間の接続を保持しません。
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # 約 24 時間はリトライしても安全
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# その後 GET /v1/videos/{task["id"]} を完了までポーリングします

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

Harga

Veo 3 ditagih per video (di sini, per klip 8 detik beresolusi 720p) dan sekitar 50–70% lebih murah daripada harga resmi Google. Resolusi yang lebih tinggi juga meningkatkan biaya—lihat tabel tingkatan lengkap di halaman harga.

Tips prompt video

• Deskripsikan shot, bukan hanya subjeknya. Gerakan kamera (dolly, pan, push-in), karakter lensa, pencahayaan, dan tempo lebih efektif daripada kata sifat.
• Tentukan rasio aspek secara eksplisit—16:9 untuk lanskap dan 9:16 untuk potret/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)—berguna saat Anda ingin menjaga konsistensi karakter atau produk tertentu.

Pertanyaan yang sering diajukan