Referensi API produksi

DeepSwapAI: API Face Swap AI

Hubungkan tukar wajah untuk foto, batch foto, foto grup terpetakan, video, dan GIF melalui satu antarmuka produksi. Tinjau kontrak, unit penagihan, status tugas, dan batasannya di sini; buka referensi API lengkap berbahasa Inggris untuk setiap field dan respons.

DeepSwapAI Product Team2026-08-27Dokumentasi API

HTTPS, unggahan multipart, dan status tugas JSON

Setiap rute pembuatan yang dipublikasikan menggunakan kunci API Bearer, mengembalikan taskId, dan menyediakan status tugas melalui GET pada rute yang sama.

OtentikasiKunci API BearerKunci hanya ditampilkan saat dibuat; server hanya menyimpan hash SHA-256-nya.
PenyelesaianPolling berdasarkan taskIdStatus akhir adalah COMPLETED, FAILED, atau CANCELLED.
PenagihanKredit akun sekali bayarPolling GET tidak menimbulkan biaya pembuatan tambahan.
Aset pengembangOpenAPI 3.1 + PostmanSaat ini belum ada SDK bahasa resmi atau callback webhook yang dipublikasikan.

Satu akun API mencakup lima jenis input tukar wajah

Foto, batch foto, wajah terpetakan dalam foto grup, video, dan GIF menggunakan domain produksi dan siklus hidup tugas yang sama. Sebelum setiap permintaan, validasi format, ukuran, durasi, jumlah target, dan kredit yang tersedia; setelah pengiriman, simpan taskId dan lakukan polling pada rute GET yang sesuai.

Rute, unit penagihan, dan batasan utama

Alur kerjaRute POSTUnit saat iniBatasan utama
FotoPOST /api/ai-tasks6 kredit / keluaranSatu wajah sumber dan satu gambar target
Batch fotoPOST /api/ai-tasks/batch-face-swap6 kredit / keluaranMaksimum 20 gambar input secara total; total 95 MB
Pemetaan grupPOST /api/ai-tasks/multi-face-swap6 kredit / wajah terpilihMaksimum 10 wajah terpetakan; total 95 MB
VideoPOST /api/ai-tasks/video3 kredit / detik yang dibulatkan; minimum 12MP4, MOV, atau WebM; 600 detik (95 MB per permintaan API, sekitar 1–1,5 menit video ponsel 1080p biasa); tingkat tertinggi tetap 1080p
GIFPOST /api/ai-tasks/gif3 kredit / detik yang dibulatkan; minimum 12GIF, MP4, atau WebM; 30 detik

Validasi permintaan sebelum mengirim tugas pembuatan

  1. 1. Simpan kunci API di server Anda, jangan pernah di browser, paket aplikasi seluler, log, atau repositori publik.
  2. 2. Validasi field multipart, jenis file, ukuran, jumlah, durasi, dan kredit untuk alur kerja yang dipilih.
  3. 3. Kirim permintaan POST dan simpan taskId yang dikembalikan beserta perkiraan biayanya.
  4. 4. Lakukan polling GET pada rute yang sama hingga tugas mencapai COMPLETED, FAILED, atau CANCELLED.
  5. 5. Kirim hasil hanya ke akun pemilik tugas dan hapus media sesuai aturan retensi yang dipublikasikan.

Tidak ada bidang idempotency-key yang didokumentasikan dalam kontrak publik. Layanan pemanggil harus menonaktifkan pengiriman duplikat, pertahankan taskId pertama, dan rekonsiliasi respons jaringan yang tidak pasti sebelum mengeluarkan POST lain.

Simpan taskId dan berhenti di status terminal

PeristiwaCatatan tugasTindakan kreditTindakan klien
Tugas diterimaPertahankan taskId dan biaya yang diharapkanPerlakukan penyelesaian sebagai milik serverMulai polling yang diukur
Tugas selesaiHasil terminalPekerjaan yang selesai tetap diselesaikanOtorisasi pengambilan hasil
Pemrosesan gagalKegagalan terminalKontrak saat ini mengembalikan dana pemrosesan yang gagal secara otomatisBaca kegagalan sebelum memutuskan untuk mengirim ulang
Hasil respons tidak pastiRekonsiliasi sebelum POST lainJangan pernah menebak dari waktu tungguGunakan taskId yang disimpan atau riwayat akun

Hasil respons tidak pasti Tidak ada bidang idempotency-key yang didokumentasikan dalam kontrak publik. Layanan pemanggil harus menonaktifkan pengiriman duplikat, pertahankan taskId pertama, dan rekonsiliasi respons jaringan yang tidak pasti sebelum mengeluarkan POST lain.

Bangun batasan yang dapat diverifikasi ke dalam integrasi Anda

Akses API memerlukan email terverifikasi dan setidaknya satu pesanan kredit berstatus PAID atau COMPLETED. Setiap akun dapat membuat hingga 3 kunci API, dengan maksimum 6 permintaan generasi per menit per kunci. Tugas yang gagal dikembalikan kreditnya sesuai aturan saat ini, dan media dihapus dalam 24 jam.

Buka referensi API lengkap berbahasa Inggris: Buka referensi API lengkap berbahasa Inggris. Kebijakan Privasi dan Harga menjelaskan ketentuan khusus produk.

Pastikan poin-poin ini sebelum peluncuran

Apakah API mendukung webhook?

Saat ini belum. Simpan taskId yang dikembalikan oleh POST dan lakukan polling GET pada rute alur kerja yang sama hingga mencapai status akhir.

Apakah ada SDK resmi?

Saat ini belum ada SDK bahasa resmi yang dipublikasikan. HTTPS standar, otentikasi Bearer, data multipart, dan respons JSON dapat digunakan dengan klien HTTP sisi server apa pun.

Berapa kredit yang digunakan satu tugas foto?

Satu foto, satu output batch, atau satu wajah terpilih dalam foto grup saat ini menggunakan 6 kredit. Video dan GIF menggunakan detik yang dibulatkan ke atas dan biaya minimum.

Bolehkah saya menaruh kunci API di kode frontend?

Tidak. Simpan kunci API di server dan jangan pernah menuliskannya ke bundle browser, biner aplikasi seluler, log, event analitik, atau tiket dukungan.

Validasi integrasi dengan satu tugas representatif

Uji field, status, biaya, dan pengiriman hasil dengan sampel media terkecil yang diizinkan sebelum meningkatkan skala ke batch atau video panjang.

Buka dokumentasi API lengkap