Tikdek API

Bangun di atas Tikdek API

Kirimkan pengalaman teks-ke-video yang didukung oleh OpenAI Sora 2 dan Sora Pro. Otentikasi dengan kunci API, status tugas polling, dan kirimkan video akhir dalam hitungan menit.

Mengapa tim mengandalkan API Sora 2

Memberikan alur kerja pembuatan video yang tangguh dengan polling yang dapat diprediksi, 20 permintaan bersamaan, dan unggahan penyimpanan otomatis.

Sora 2 + Stabil + Pro

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

Jajak pendapat yang dapat diprediksi

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

20 permintaan bersamaan

Memproses hingga 20 tugas pembuatan video secara bersamaan. Hubungi kami untuk batas yang lebih tinggi.

Otentikasi & URL Dasar

Semua titik akhir berada di bawah https://sora2-api.com/api. Berikan kunci API yang dibuat di konsol melalui header Otorisasi.

  • Kirim header Otorisasi: Pembawa YOUR_API_KEY dengan setiap permintaan.
  • Gunakan Tipe Konten: application/json saat memposting muatan.
  • Setiap permintaan generasi mengurangi kredit berdasarkan model dan durasi: sora-2/sora-2-stable 10s (100) atau 15s (150), sora-2-pro (150); pekerjaan yang gagal dikembalikan secara otomatis.

Titik akhir inti

Mulailah dengan membuat tugas pembuatan, lalu lakukan polling atau dengarkan hasilnya.

Buat video Sora 2

Mulailah pekerjaan pembuatan Sora 2 atau Sora Pro dengan perintah teks-ke-video atau gambar-ke-video opsional.

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

Parameter muatan

  • model: Diperlukan. Gunakan "sora-2", "sora-2-stable", atau "sora-2-pro".
  • prompt: Diperlukan. Deskripsi bahasa alami dari adegan yang ingin Sora buat.
  • imageData: Opsional (disarankan). URL data Base64 dengan awalan "data:image/*;base64," untuk mode gambar-ke-video.
  • url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
  • aspectRatio: Opsional. Nilai yang didukung: "9:16" (default) atau "16:9".
  • isPublic: Opsional. Apakah akan menampilkan video tersebut secara publik; standarnya benar.
  • remixTargetId: Opsional (khusus VIP). Targetkan pid video untuk fitur kelanjutan/remix.
  • characters: Opsional (khusus VIP). Array kontrol karakter; setiap item menyertakan url dan stempel waktu.

Catatan

  • Respons segera kembali dengan taskId; pemeriksaan hasil polling hingga status berhasil atau gagal.

Permintaan sampel

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-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

Contoh tanggapan

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

Periksa hasil generasi

Jajak pendapat status terbaru untuk tugas pembuatan guna melacak kemajuan dan mengambil hasil.

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

Parameter muatan

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

Catatan

  • Titik akhir memverifikasi tugas tersebut milik akun Anda sebelum mengembalikan data.
  • Pekerjaan yang gagal mengembalikan kredit secara otomatis dan menampilkan metadata pengembalian dana sebagai respons.

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": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

Dapatkan kredit pengguna dan status VIP

Tanyakan kredit yang tersedia dan status keanggotaan VIP pengguna saat ini.

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

Catatan

  • Membutuhkan sesi login atau token API yang valid untuk mengakses informasi pengguna.
  • Mengembalikan kolom status left_credits, is_recharged, is_pro, 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_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}

1. Buat tugas

Kirim permintaan Tikdek dengan prompt Anda, lalu simpan taskId yang dikembalikan.

2. Lacak kemajuan

Panggil titik akhir hasil pemeriksaan hingga statusnya menjadi berhasil atau gagal.

3. 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.

Sumber daya yang bermanfaat

Luncurkan dengan Tikdek hari ini

Buat kunci API Anda dan mulai buat video AI sinematik dalam hitungan menit.