Panduan Python

API AI gambar ke video dengan Python

Buat tugas dari satu gambar, lacak dengan aman, lalu unduh video yang selesai.

Python: buat, lacak, unduh
import os
import time
import requests

base_url = "https://sora2-api.com"
headers = {
    "Authorization": f"Bearer {os.environ['TIKDEK_API_KEY']}",
    "Content-Type": "application/json",
}

created = requests.post(
    f"{base_url}/api/v1/video/sora-video",
    headers=headers,
    json={
        "model": "sora-2-pro",
        "prompt": "Slow camera push-in, rain moving across the frame",
        "url": "https://example.com/reference-frame.jpg",
        "aspectRatio": "16:9",
        "webHook": "-1",
        "isPublic": False,
    },
    timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"]["id"]

for _ in range(90):
    response = requests.post(
        f"{base_url}/api/video-generations/check-result",
        headers=headers,
        json={"taskId": task_id},
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()["data"]

    if task["status"] == "succeeded":
        video = requests.get(task["result_url"], timeout=120)
        video.raise_for_status()
        open("result.mp4", "wb").write(video.content)
        break

    if task["status"] == "failed":
        raise RuntimeError(task.get("error_message") or "Generation failed")

    time.sleep(4)
else:
    raise TimeoutError(f"Task {task_id} did not finish in time")

Siklus permintaan Python lengkap

Contoh memakai endpoint Tikdek aktif dan menangani semua status akhir.

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.

Alur integrasi yang direkomendasikan

Siapkan integrasi untuk produksi

Simpan kunci di server, batasi percobaan, catat ID tugas, dan simpan hasil segera.

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.

Dari skrip ke produksi

Buat kunci, jalankan contoh, lalu tambahkan webhook saat beban meningkat.