Tikdek Video API

Integrasikan Sora 2 Pro melalui API

Buat tugas video teks, gambar, atau storyboard dengan /api/v1/video/sora-pro, lalu polling status dan berikan hasil dengan hasil periksa.

Semua yang Anda butuhkan untuk pengiriman Sora 2 Pro

One API mencakup alur kerja Sora 2, Sora 2 Pro, dan storyboard dengan penagihan yang jelas dan polling yang dapat diprediksi.

Tujuh model yang didukung

Pilih dari varian teks/gambar Sora 2, teks/gambar Sora 2 Stabil, dan varian teks/gambar/papan cerita Sora 2 Pro.

Kredit berjenjang

Skala kredit dengan durasi dan kualitas, termasuk standar/tinggi untuk Sora 2 Pro.

Pengiriman berbasis tugas

Buat tugas, periksa hasil jajak pendapat, dan kirimkan hasil akhir_url.

Otentikasi & URL Dasar

Semua titik akhir dilayani dari https://sora2-api.com. Kirim kunci API dari konsol di header Otorisasi.

  • Sertakan Otorisasi: Pembawa YOUR_API_KEY pada setiap permintaan.
  • Gunakan Tipe Konten: application/json untuk muatan JSON.
  • Respons mencakup kode/pesan/data; hasil pemeriksaan dapat mengembalikan 4xx/5xx jadi validasi status HTTP juga.

Kredit & penagihan

Penagihan bervariasi menurut model, durasi, dan tingkat kualitas.

  • Teks/gambar Sora 2: 10s = 100 sks, 15s = 150 sks.
  • Sora 2 Teks/gambar stabil: 10 detik = 100 sks, 15 detik = 150 sks.
  • Teks/gambar Sora 2 Pro: 10 detik = 375, 15 detik = 675.
  • Papan cerita Sora 2 Pro: 10 detik = 375, 15 detik = 675, 25 detik = 875.
  • Harga di atas bersifat final; biaya dibulatkan.

Titik akhir inti

Mulailah dengan membuat tugas pembuatan, lalu lakukan polling atau periksa saldo kredit Anda.

Buat video Sora 2 Pro

Kirimkan pekerjaan teks, gambar, atau storyboard, segera kurangi kredit, dan terima taskId.

Metode: POSTJalan: /api/v1/video/sora-pro

Parameter muatan

  • model: Wajib. Gunakan salah satu string model yang didukung di atas.
  • cepat: Diperlukan kecuali untuk storyboard. Jelaskan adegan yang ingin Anda hasilkan.
  • imageData: Diperlukan untuk gambar-ke-video. URL data Base64 dengan awalan "data:image/*;base64,".
  • imageUrl: Opsional. URL gambar publik jika Anda memilih untuk tidak mengirim base64.
  • Rasio aspek: Opsional. "lanskap" atau "potret" (lanskap default).
  • nFrame: Opsional. "10"/"15"/"25" (25 hanya untuk storyboard).
  • ukuran: Opsional (teks/gambar Pro). "standar" atau "tinggi".
  • hapusTanda Air: Opsional (teks/gambar). Hapus tanda tanda air, defaultnya benar.
  • tembakan: Diperlukan untuk storyboard. Rangkaian pengambilan gambar dengan adegan dan durasi.
  • isPublik: Opsional. Apakah hasilnya bersifat publik, defaultnya benar.

Catatan

  • Model yang didukung: sora-2-teks-ke-video, sora-2-gambar-ke-video, sora-2-teks-ke-video-stabil, sora-2-gambar-ke-video-stabil, sora-2-pro-teks-ke-video, sora-2-pro-gambar-ke-video, sora-2-pro-storyboard.
  • Kredit dipotong saat diserahkan; pekerjaan yang gagal dikembalikan secara otomatis.
  • Mode storyboard memerlukan rangkaian pengambilan gambar.

Struktur tembakan

Diperlukan untuk permintaan storyboard; setiap item menentukan adegan dan durasi.

[
  { "scene": "Kafe yang nyaman saat matahari terbit, cahaya hangat.", "duration": 7.5 }
]
  • adegan: Deskripsi bidikan.
  • durasi: Detik (mendukung desimal seperti 7,5).

Permintaan sampel

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "Pelacakan sinematik dilakukan melalui pasar jalanan yang diterangi lampu neon saat senja.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Contoh tanggapan

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

Periksa hasil generasi

Status tugas jajak pendapat dan hasil sinkronisasi.

Metode: POSTJalan: /api/video-generations/check-result

Parameter muatan

  • taskId: Diperlukan. Pengidentifikasi dikembalikan saat Anda membuat tugas pembuatan.

Catatan

  • Mengembalikan status, kemajuan, dan result_url bila tersedia.
  • Dapat mengembalikan 4xx/5xx untuk validasi, izin, atau kasus tidak ditemukan.

Permintaan sampel

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

Contoh tanggapan

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Dapatkan kredit pengguna

Ambil sisa kredit dan status VIP.

Metode: POSTJalan: /api/get-user-credits

Catatan

  • Memerlukan kunci atau sesi API yang valid.
  • Mengembalikan kolom left_credits dan is_vip.

Permintaan sampel

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Contoh tanggapan

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

1. Buat tugas

Kirim /api/v1/video/sora-pro dengan payload Anda, lalu simpan taskId.

2. Lacak kemajuan

Lakukan polling /api/video-generasi/cek-hasil hingga status berhasil atau gagal.

3. Kirimkan videonya

Gunakan result_url/result_urls untuk mendistribusikan atau menyimpan video yang dihasilkan.

Pertanyaan yang sering diajukan

Model mana yang didukung?

Gunakan sora-2-teks-ke-video atau sora-2-gambar-ke-video; Sora 2 Pro menambahkan varian teks, gambar, dan storyboard.

Nilai apa yang didukung nFrames?

Gunakan "10" atau "15" untuk semua mode; "25" hanya untuk storyboard. Teks/gambar pro mendukung ukuran standar atau tinggi.

Mengapa hasil pemeriksaan dapat mengembalikan 4xx/5xx?

Titik akhir memvalidasi kepemilikan dan masukan, sehingga tugas yang tidak valid atau tidak sah dapat mengembalikan 4xx/5xx bersama kode/pesan.

Sumber daya yang bermanfaat

Luncurkan dengan Tikdek Video API

Buat kunci API Anda dan mulai buat video Sora 2 Pro dalam hitungan menit.