Panduan migrasi

Rencanakan masa setelah Sora 2

Jaga produk stabil dengan kontrak netral, penyimpanan sendiri, dan model cadangan teruji.

Bentuk permintaan netral penyedia
type VideoGenerationRequest = {
  prompt: string;
  imageUrl?: string;
  aspectRatio: "16:9" | "9:16";
  durationSeconds: number;
  quality: "standard" | "high";
  callbackUrl?: string;
};

type VideoGenerationResult = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed";
  progress: number;
  outputUrl?: string;
  errorCode?: string;
};

interface VideoProvider {
  create(input: VideoGenerationRequest): Promise<{ id: string }>;
  retrieve(id: string): Promise<VideoGenerationResult>;
}

Pisahkan produk dari model

Normalkan input, status, kesalahan, dan URL sebelum kode khusus penyedia.

Sora 2 + Stabil + Pro

Pilih model string yang sesuai dengan kebutuhan kualitas dan biaya Anda: sora-2, sora-2-stable, atau sora-2-pro.

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.

Jajak pendapat yang dapat diprediksi

Buat tugas, lalu lakukan polling titik akhir hasil pemeriksaan untuk menjaga status dan kemajuan tetap sinkron tanpa SSE.

Alur integrasi yang direkomendasikan

Batas waktu migrasi

OpenAI berencana menghentikan Sora 2 dan Videos API pada 24 September 2026. Uji cadangan.

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.

Jadikan pergantian model sebagai rutinitas

Pertahankan endpoint stabil dan simpan pilihan penyedia dalam adapter yang dapat diganti.