Harga Sora API — menghasilkan video AI pada endpoint mirip OpenAI (saat ini dengan Veo 3.1)

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

Apa itu Sora API?

Sora (Sora 2 dan Sora 2 Pro) mengubah prompt teks — atau gambar diam — menjadi klip video pendek, dengan audio tersinkronisasi pada Sora 2. Bentuk API memungkinkan Anda membuat skrip untuk proses pembuatan dalam pipeline: video pemasaran, animasi produk, B-roll, dan pratinjau storyboard. Bentuknya sama di berbagai model video modern: kirim prompt dan parameter, lalu dapatkan 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 text-to-video yang aktif adalah Google Veo 3, yang menghasilkan klip sinematik dengan audio bawaan. Contoh di bawah menggunakan veo-3 — ketika Sora tersedia, satu-satunya perubahan adalah kolom model.

Mulai cepat text-to-video

POST dengan kunci Kunavo Anda. Pembuatan dapat memerlukan beberapa menit, sehingga panggilan sinkron mempertahankan koneksi hingga klip selesai:

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,  # die Generierung kann Minuten dauern
)
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, kirimkan image_url (URL https atau file yang telah Anda unggah ke /v1/files) bersama prompt. Untuk gerakan terkontrol, Anda dapat mengirimkan frame pertama dan terakhir menggunakan image_urls dan image_mode: "frame". Contoh lengkap tersedia dalam dokumentasi video.

Siklus hidup tugas asinkron

Dalam produksi, Anda sebaiknya tidak mempertahankan koneksi selama 10 menit. Kirimkan tugas ke /v1/videos, dapatkan ID tugas segera, lalu lakukan polling pada GET /v1/videos/{id} hingga selesai. URL hasil bersifat permanen.

# Produktion: Task einreichen, dann pollen — keine langlebige Verbindung.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # innerhalb von ~24h retry-sicher
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# dann GET /v1/videos/{task["id"]} pollen, bis er fertig ist

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

Harga

Veo 3 ditagihkan per video (di sini per klip 8 detik dalam 720p), sekitar 50–70% di bawah harga resmi Google. Resolusi yang lebih tinggi berbiaya lebih mahal — tabel tingkatan lengkap tersedia di halaman harga.

Tips prompting untuk video

• Deskripsikan 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 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) jika Anda ingin karakter atau produk tertentu tetap konsisten.

Pertanyaan umum