API Motion Control

Satu API untuk produksi video motion control.

Unggah satu gambar acuan beserta satu video gerak, lalu terima satu video hasil. Empat model siap produksi, autentikasi lewat satu header, dan hasil dikirim melalui CDN.

Daftar Gratis Lihat Dokumentasi

Autentikasi menggunakan header X-API-Key. Permintaan dijawab langsung dengan kode 202, status pekerjaan dipantau melalui endpoint job.

kirim-job.shPOST /jobs

# Kirim gambar dan video, lalu terima ID job
curl -X POST https://alrizmotion.my.id/api/jobs \
  -H "X-API-Key: $ALRIZ_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"mc-kling-2.6-pro","image_url":"…","video_url":"…"}'

Respons 202

{
  "job_id": "jb_8f2c41a9",
  "status": "QUEUED"
}

Model produksi tersedia

1080p

Resolusi hingga Full HD

30 detik

Durasi maksimum per permintaan

CDN

Distribusi hasil berkecepatan tinggi

Katalog model

Empat model, satu antarmuka.

Setiap model memiliki resolusi keluaran dan profil kualitas tersendiri. Pilih sesuai kebutuhan produksi Anda, tanpa perlu menyesuaikan integrasi.

Motion Control 2.6

mc-kling-2.6-std

Standar · 720p

Standar produksi harian dengan biaya paling ringan.

Resolusi

720p

Durasi

≤ 30 detik

Input

Gambar + video

Harga

Rp750

Motion Control 2.6 Pro

mc-kling-2.6-pro

Pro · 1080p

Detail lebih tajam untuk keluaran Full HD.

Resolusi

1080p

Durasi

≤ 30 detik

Input

Gambar + video

Harga

Rp1.500

Motion Control 3.0

mc-kling-3.0-std

Standar · 720p

Generasi terbaru dengan gerakan lebih halus.

Resolusi

720p

Durasi

≤ 30 detik

Input

Gambar + video

Harga

Rp1.000

Motion Control 3.0 Pro

mc-kling-3.0-pro

Pro · 1080p

Kualitas tertinggi untuk kebutuhan komersial.

Resolusi

1080p

Durasi

≤ 30 detik

Input

Gambar + video

Harga

Rp1.750

Harga

Satu harga tetap per model.

Harga berlaku per video hasil dan tidak berubah mengikuti beban sistem. Biaya ditagih dari saldo akun Anda setiap job berhasil diselesaikan.

Model	Resolusi	Harga	Satuan
Motion Control 2.6 mc-kling-2.6-std	720p	Rp750	per video
Motion Control 2.6 Pro mc-kling-2.6-pro	1080p	Rp1.500	per video
Motion Control 3.0 mc-kling-3.0-std	720p	Rp1.000	per video
Motion Control 3.0 Pro mc-kling-3.0-pro	1080p	Rp1.750	per video

Harga sudah termasuk penyimpanan hasil dan distribusi melalui CDN.

Cara kerja

Tiga langkah, satu video.

Semua permintaan cukup menyertakan header X-API-Key. Tidak ada proses login, tidak ada sesi, dan tidak ada cookie.

Kirim job

Unggah gambar acuan, video gerak, nama model, dan prompt. Server langsung menjawab dengan ID job.

POST /jobs

Pantau status

Panggil endpoint ini secara berkala untuk memantau progres sampai status job berubah menjadi selesai.

GET /jobs/{id}

Ambil hasil

Setelah job selesai, ambil tautan video hasilnya. Unduhan berjalan langsung dari CDN, tidak melalui server kami.

GET /jobs/{id}/result

Contoh kode

Mulai dari satu permintaan.

Pilih bahasa yang Anda gunakan. Semua contoh memakai kunci dan endpoint yang sama, sehingga mudah dipindahkan ke proyek Anda.

# 1. Kirim job
curl -X POST https://alrizmotion.my.id/api/jobs \
  -H "X-API-Key: $ALRIZ_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mc-kling-2.6-pro",
    "image_url": "https://…/foto.jpg",
    "video_url": "https://…/gerak.mp4",
    "prompt": "gerakkan rambut mengikuti angin"
  }'

# 2. Pantau status
curl https://alrizmotion.my.id/api/jobs/JOB_ID \
  -H "X-API-Key: $ALRIZ_KEY"

# 3. Ambil hasil
curl https://alrizmotion.my.id/api/jobs/JOB_ID/result \
  -H "X-API-Key: $ALRIZ_KEY"

Status job

Tujuh keadaan, satu alur.

Status job berubah berurutan dari antrean sampai selesai. Nilai akhir hanya DONE, NO_STOCK, atau FAILED.

QUEUED · Menunggu antreanCLAIMING · Menyiapkan kapasitasUPLOADING · Mengunggah berkasPROCESSING · Sedang diprosesSAVING · Menyimpan hasilDONE · SelesaiNO_STOCK · Kapasitas habisFAILED · Gagal

Kode error

Setiap kesalahan punya kode sendiri.

Setiap kesalahan dikirim dalam format JSON dengan kode tetap, status HTTP, dan keterangan yang jelas. Kode ini tidak berubah di setiap versi, sehingga aman dipakai untuk penanganan otomatis.

Kode	HTTP	Keterangan
AUTH_001	401	Kunci API tidak disertakan atau sesi tidak valid. Sertakan header `X-API-Key`.
AUTH_002	403	Kunci API sudah dicabut, akun ditangguhkan, atau akses khusus administrator.
REQ_001	400	Permintaan tidak lengkap atau tidak memenuhi syarat: `model` tidak diisi, `image_url` dan `video_url` keduanya kosong, atau saldo tidak cukup.
REQ_002	400	Email sudah terdaftar (saat mendaftar akun).
REQ_003	413	err.REQ_003
REQ_004	415	err.REQ_004
REQ_005	422	Kolom permintaan tidak valid (mis. `model` tidak dikenal, nilai di luar batas, atau tipe salah).
JOB_001	404	Job, kunci, atau tagihan tidak ditemukan, atau bukan milik kunci API ini.
JOB_002	409	Job belum selesai diproses, atau aksi tidak diizinkan untuk status job saat ini.
STK_001	503	Tidak ada kapasitas untuk model ini saat ini. Saldo Anda dikembalikan penuh. Silakan coba beberapa saat lagi.
GEN_001	502	Proses gagal di sisi layanan setelah beberapa kali percobaan dengan akun berbeda. Job dihentikan dan saldo Anda dikembalikan penuh.
GEN_002	422	Berkas masukan ditolak: gambar atau video tidak dapat dipakai untuk model ini (format tidak didukung, berkas rusak, atau wajah/subjek tidak terdeteksi). Saldo Anda dikembalikan penuh.
SYS_001	429	Terlalu banyak generasi bersamaan. Tunggu sampai sebagian job selesai, lalu coba lagi.
SYS_002	500	Terjadi kesalahan internal. Silakan coba lagi; bila berulang, hubungi dukungan.

Sudah punya kunci API? Langsung coba.

Console menampilkan saldo, riwayat job, dan pemakaian per model. Dokumentasi memuat seluruh endpoint beserta kode errornya.

Daftar Sekarang Dokumentasi