Dokumentasi API

API Publik DeepManim v1

Memulai

API DeepManim memungkinkan Anda membuat video animasi edukatif melalui kode. Buat video dari prompt teks, perbaiki secara bertahap, dan tambahkan narasi—semuanya melalui REST API yang sederhana.

URL dasar: https://api.deepmanim.com/api/v1

Catatan penting

  • Audio saat pembuatan: Saat membuat video baru melalui /generate, narasi audio disertakan secara bawaan.
  • Tidak ada audio pada modifikasi: Saat memperbaiki video melalui /improve, hasilnya tidak menyertakan audio. Selesaikan semua modifikasi terlebih dahulu, lalu tambahkan audio melalui /audio setelah videonya sesuai.
  • Perkiraan waktu: Pembuatan video memerlukan sekitar 6 menit. Kolom estimated_time_remaining_seconds pada respons job menampilkan hitung mundur secara langsung.

Autentikasi

Semua permintaan API memerlukan kunci API. Buat kunci dari Pengaturan → Kunci API di aplikasi.

Memerlukan pembelian kredit. Akses API tersedia bagi pengguna yang pernah membeli kredit setidaknya sekali. Kredit tingkat gratis saja tidak cukup.

Sertakan kunci Anda di header Authorization:

Authorization: Bearer dm_k_your_api_key_here

Rahasiakan kunci API Anda. Jangan membagikannya di repositori publik atau aplikasi sisi klien.

Mulai cepat

Buat video dalam tiga langkah: buat job, pantau sampai selesai, lalu ambil hasilnya.

1. Buat video

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Jelaskan cara kerja fotosintesis", "preferred_locale": "id"}'

2. Pantau sampai selesai

curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer dm_k_your_key"

# Respons berisi:
#   status: "pending" | "running" | "completed" | "failed"
#   phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done"
#   estimated_time_remaining_seconds: 285

3. Dapatkan hasil

# Saat statusnya "completed", respons berisi:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "Animasi yang menjelaskan fotosintesis...",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "Bagaimana respirasi sel berkaitan dengan fotosintesis?"
  }
}

Endpoint

Pembuatan video

Job

Session

Pesan

Akun

Kredit dan harga

Setiap panggilan API yang membuat job akan mengurangi kredit dari saldo Anda:

OperasiBiaya
Buat videoMulai dari 1,5 kredit
Perbaiki videoMulai dari 1,5 kredit
Tambahkan audio1 kredit
Perbaiki narasi1 kredit

Biaya pembuatan dan perbaikan bergantung pada preset yang dipilih dan saat ini berkisar antara 1,5 hingga 70 kredit. Membaca session, pesan, status job, dan informasi akun gratis serta tidak mengurangi kredit.

Respons kesalahan

StatusArti
401Kunci API tidak ada atau tidak valid
402Kredit tidak mencukupi
404Sumber daya tidak ditemukan (session, pesan, atau job)
400Permintaan tidak valid (misalnya tidak ada video untuk diperbaiki atau tidak ada narasi untuk disempurnakan)
Dokumentasi API | DeepManim