cicora.ai
Spesifikasi APIMedia asinkron

Video

Mulai pembuatan video sebagai tugas asinkron, simpan ID tugasnya, dan pisahkan pembuatan dari pembacaan hasil.

Referensi integrasi: pilih parameter dan kemampuan yang tersedia dari pengaturan API akun Anda dan katalog model untuk lingkungan Anda.

Buat tugas

Permintaan video umumnya memuat prompt, model, dan properti frame, seperti durasi, rasio aspek, resolusi, atau referensi, yang disertakan hanya jika didukung model terpilih.

Simpan ID tugas segera. ID ini diperlukan untuk menampilkan kemajuan, mendukung pembatalan di antarmuka Anda, dan memperoleh konten akhir.

Tugas pembuatan video
bash
curl --request POST https://cicora.ai/api/v1/videos \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/veo-3.1",
    "prompt": "Slow aerial movement above a river at sunrise",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Polling status

  • Baca tugas melalui GET /videos/{video_id}.
  • Jadikan status terminal sebagai sumber kebenaran untuk penyelesaian.
  • Gunakan interval polling yang makin panjang dan hentikan polling ketika pengguna keluar.

Gunakan hasil

Setelah selesai, gunakan URL atau konten yang dikembalikan oleh tugas dan verifikasi kesiapan file sebelum menampilkan pemutar.

Simpan prompt, model, parameter, dan ID tugas untuk dukungan, tetapi jangan menyimpan referensi input lebih lama daripada yang diperlukan produk Anda.