Jajak pendapat yang dapat diprediksi
Buat tugas, lalu lakukan polling titik akhir hasil pemeriksaan untuk menjaga status dan kemajuan tetap sinkron tanpa SSE.
Pengiriman asinkron
Tugas video andal dengan status dan webhook
Pakai polling untuk klien sederhana atau webhook untuk pengiriman otomatis.
Buat tugas dengan webhook
curl -X POST https://sora2-api.com/api/v1/video/sora-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A tracking shot through a quiet night market",
"aspectRatio": "16:9",
"webHook": "https://api.example.com/webhooks/video",
"isPublic": false
}'
# Your webhook receives a terminal payload:
{
"id": "task_123",
"status": "succeeded",
"progress": 100,
"results": [{ "url": "https://storage.example/video.mp4" }]
}Satu siklus, dua pola pengiriman
Simpan setiap ID dan perlakukan succeeded serta failed sebagai status akhir.
20 permintaan bersamaan
Memproses hingga 20 tugas pembuatan video secara bersamaan. Hubungi kami untuk batas yang lebih tinggi.
Penagihan transparan
Setiap panggilan dikenakan biaya 100 kredit untuk 10 detik sora-2/sora-2-stable, 150 kredit untuk 15 detik sora-2/sora-2-stable, atau 150 kredit untuk sora-2-pro, dengan pengembalian dana otomatis ketika generasi gagal.
Alur integrasi yang direkomendasikan
Aturan pengiriman webhook
Balas 2xx dengan cepat, proses secara idempoten, dan simpan polling sebagai pemulihan.
Buat tugas
Kirim permintaan Tikdek dengan prompt Anda, lalu simpan taskId yang dikembalikan.
Lacak kemajuan
Panggil titik akhir hasil pemeriksaan hingga statusnya menjadi berhasil atau gagal.
Kirimkan videonya
Gunakan URL yang didukung penyimpanan di result_url/result_urls untuk menayangkan atau mengunduh video yang dihasilkan.
Pertanyaan yang sering diajukan
Bagaimana cara mengautentikasi permintaan saya?
Buat kunci API di konsol, lalu sertakan sebagai Otorisasi: Pembawa YOUR_API_KEY. Kunci dapat diputar kapan saja.
Bagaimana cara saya melakukan jajak pendapat untuk mendapatkan hasil?
Setelah memanggil buat, simpan taskId. Panggil /api/video-generasi/check-result setiap 3-5 detik hingga status berhasil atau gagal, lalu gunakan result_url/result_urls.
Bagaimana kredit ditangani jika terjadi kegagalan?
Kami secara otomatis mengembalikan dana kredit ketika tugas gagal dan mengembalikan refund_trans_no plus credits_refunded=true dalam payload hasil cek untuk jejak audit.
Kirim generasi asinkron yang tangguh
Mulai dengan polling lalu tambahkan webhook tanpa mengubah kontrak generasi.