Apa yang dilakukan API tukar wajah
API tukar wajah menerima dua gambar dan mengembalikan gambar baru. Gambar sumber menampilkan wajah yang ingin kamu pakai. Gambar target adalah foto yang ingin kamu ubah. API menemukan wajah di target, menggantinya dengan wajah dari sumber, lalu menyelaraskan warna kulit, cahaya, dan sudut agar hasilnya terlihat seperti satu foto.
Developer memakainya untuk hal-hal seperti kartu ucapan personal, kampanye "tampilkan dirimu di poster", tool avatar dan profil, karakter game, serta aplikasi photo booth di acara. Daripada melatih dan meng-hosting model sendiri, kamu cukup mengirim satu request HTTP dan menerima gambar.
Sebelum mulai
Kamu butuh tiga hal:
- Akun Morfran. Akun baru mendapat 50 kredit gratis, cukup untuk sepuluh kali tukar wajah tunggal.
- API key. Buat di dasbor kamu pada bagian API key. Simpan di server kamu dan jangan pernah memasukkannya ke kode browser atau aplikasi mobile.
- Dua URL gambar publik. JPG, PNG, atau WebP. Sumber harus menampilkan satu wajah yang jelas dan kurang lebih menghadap kamera.
Setiap request mengirim key di header X-API-Key. URL dasarnya adalah https://api.morfran.com.
Tukar wajah pertamamu dengan curl
curl -X POST https://api.morfran.com/v1/face-swap \
-H "X-API-Key: $MORFRAN_KEY" \
-H "Content-Type: application/json" \
-d '{"SourceImageUrl":"https://example.com/face.jpg","TargetImageUrl":"https://example.com/photo.jpg"}'
Secara default panggilannya sinkron: API menunggu hasilnya (sampai sekitar 60 detik) lalu mengembalikan respons JSON berisi tautan ke gambar jadi di cdn.morfran.com, beserta kredit yang terpakai. Langsung unduh gambarnya, karena hasil dihapus setelah satu jam.
Request yang sama dalam JavaScript (Node.js)
const res = await fetch("https://api.morfran.com/v1/face-swap", {
method: "POST",
headers: {
"X-API-Key": process.env.MORFRAN_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
SourceImageUrl: "https://example.com/face.jpg",
TargetImageUrl: "https://example.com/photo.jpg",
}),
});
const data = await res.json();
console.log(res.status, data);
Jalankan ini di server kamu, bukan di browser, supaya key kamu tetap rahasia.
Request yang sama dalam Python
import os
import requests
res = requests.post(
"https://api.morfran.com/v1/face-swap",
headers={"X-API-Key": os.environ["MORFRAN_KEY"]},
json={
"SourceImageUrl": "https://example.com/face.jpg",
"TargetImageUrl": "https://example.com/photo.jpg",
},
timeout=90,
)
print(res.status_code, res.json())
Pekerjaan yang lama: pakai mode async
Kalau aplikasi kamu tidak boleh menunggu di request yang terbuka, tambahkan ?async=true ke URL. API langsung menjawab dengan task id. Lalu baca hasilnya dengan GET /v1/face-swap/{taskId} setiap beberapa detik sampai selesai. Cara ini cocok di belakang antrean job, atau saat server kamu sendiri punya timeout request yang pendek.
Foto grup: tukar hingga delapan wajah
Untuk foto tim atau foto keluarga, gunakan POST /v1/face-swap/group. Endpoint ini mengubah hingga delapan wajah dalam satu panggilan; MaxFaces menentukan batasnya. Tukar wajah grup memakai 10 kredit, tukar wajah tunggal 5 kredit. Daftar lengkap field ada di dokumentasi API dan skema OpenAPI.
Menangani error dan kredit
- 401: API key tidak ada atau salah. Periksa header
X-API-Key. - 402: kredit tidak cukup. Beli paket kredit di dasbor kamu.
- 422: tidak ada wajah yang ditemukan. Minta pengguna mengirim foto yang lebih jelas dengan satu wajah.
Request yang gagal tidak dikenai biaya. Kredit hanya diambil untuk gambar yang jadi, jadi mencoba ulang setelah 422 tidak membuat biaya dua kali. Kamu bisa membaca saldo kapan saja dengan GET /v1/credits/balance, dan itu gratis.
Tips untuk hasil yang lebih baik
- Pakai wajah sumber yang jelas. Satu orang, menghadap kamera, mata terbuka, tanpa kacamata hitam, cahaya bagus.
- Samakan sudutnya. Wajah yang menghadap lurus ke depan paling menyatu dengan target di mana orangnya juga kurang lebih menghadap kamera.
- Pastikan wajah cukup besar. Wajah yang lebarnya hanya beberapa piksel di target tidak bisa ditukar dengan baik.
- Cahaya yang mirip membantu. Wajah yang difoto di siang hari terlihat paling alami di foto target yang juga diambil di siang hari.
- Uji dengan gambar asli kamu. Pakai beberapa kredit gratis untuk foto yang mirip dengan yang akan diunggah pengguna kamu.
Persetujuan dan privasi
Tukar hanya wajah orang yang sudah setuju. Jangan gunakan tukar wajah untuk menipu orang, menyamar sebagai seseorang, atau membuat konten yang merugikan orang sungguhan. Kalau kamu memublikasikan hasilnya, beri label bahwa itu dibuat dengan AI. Gambar yang diunggah dan hasilnya dihapus dari penyimpanan kami dalam satu jam, dan kami tidak memakainya untuk melatih model AI. Penyalahgunaan bisa dilaporkan lewat halaman kontak dan ditangani dalam 48 jam.
Pakai dari agen AI
Tukar wajah yang sama tersedia di server MCP Morfran di https://api.morfran.com/mcp, jadi asisten seperti Claude bisa memanggilnya dengan API key kamu. Cara pengaturannya dijelaskan di bagian MCP dokumentasi.
Pertanyaan
Berapa biaya API tukar wajah?
Tukar wajah tunggal memakai 5 kredit dan tukar wajah grup (hingga delapan wajah) memakai 10 kredit. Akun baru mendapat 50 kredit gratis. Setelah itu kamu membeli paket kredit; tidak ada langganan. Lihat harga untuk paketnya.
Berapa lama proses tukar wajah?
Sebagian besar hasil kembali dalam waktu tunggu sinkron sekitar 60 detik. Untuk pekerjaan yang lama atau timeout server yang pendek, pakai ?async=true dan baca hasilnya dengan task id.
Bisakah saya mengirim gambar sebagai base64, bukan URL?
Contoh di sini memakai URL publik, cara yang paling sederhana. Skema OpenAPI mencantumkan semua field input yang diterima endpoint ini.
Berapa lama hasil disimpan?
Gambar yang diunggah dan hasilnya dihapus dalam satu jam. Simpan gambar hasil di sisi kamu begitu kamu menerimanya.
Bisakah saya mencobanya tanpa menulis kode?
Bisa. Masuk lalu buka Playground. Playground menjalankan tukar wajah yang sama di browser dan menampilkan request API yang sesuai.