Panduan Sora API — pembuatan video AI yang langsung dapat digunakan (Veo 3.1)

Sora adalah model text-to-video OpenAI, sedangkan “Sora API” adalah cara membuat video secara terprogram, bukan aplikasi konsumen. Saat ini di Kunavo, text-to-video dijalankan dengan Google Veo 3 melalui satu endpoint video bergaya OpenAI — dukungan Sora ada dalam roadmap, dan karena endpoint tidak bergantung pada model, pindah ke Sora nanti 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 gambar diam menjadi klip video pendek, dengan audio tersinkronisasi pada Sora 2. Dalam bentuk API, Anda dapat membuatnya melalui skrip sebagai bagian dari pipeline: potongan pemasaran, animasi produk, b-roll, dan pratinjau storyboard. Model video terbaru semuanya memiliki bentuk yang sama: kirim prompt dan parameter, lalu terima URL video yang dihosting.

Video Kunavo saat ini: Veo 3

Kunavo menyediakan pembuatan video melalui satu endpoint bergaya OpenAI /v1/video/generations. Sora belum diaktifkan dalam katalog, dan model text-to-video yang tersedia saat ini adalah Google Veo 3, yang membuat klip sinematik dengan audio native. Contoh di bawah menggunakan veo-3 — ketika Sora ditambahkan, yang perlu diubah hanyalah field model.

Mulai cepat text-to-video

Satu POST dengan kunci Kunavo sudah cukup. Pembuatan dapat memerlukan 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": "빨간 종이학이 펼쳐지는 영화적인 돌리인, 부드러운 조명",
        "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 menjadi video

Untuk menambahkan gerakan pada gambar diam, kirimkan image_url (URL https atau file yang diunggah ke /v1/files) bersama prompt. Untuk gerakan terkontrol, Anda dapat mengirimkan frame pertama dan terakhir melalui image_urls dan image_mode: "frame". Contoh lengkap tersedia di dokumentasi video.

Siklus hidup tugas asinkron

Dalam produksi, jangan pertahankan koneksi selama 10 menit. Kirim tugas ke /v1/videos, segera terima ID tugas, lalu polling GET /v1/videos/{id} hingga 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 membahas loop polling lengkap, kunci idempotensi, dan pengiriman webhook.

Harga

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

Tips membuat prompt video

• Deskripsikan shot, bukan hanya subjeknya. Gerakan kamera (dolly, pan, push-in), nuansa lensa, pencahayaan, dan pacing lebih penting daripada kata sifat.
• Sebutkan rasio aspek — gunakan 16:9 untuk lanskap dan 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 (image-to-video). Ini berguna saat karakter atau produk tertentu harus tetap konsisten.

Pertanyaan yang sering diajukan