Hapus latar

Tujuan

Menghapus latar belakang dari gambar yang diunggah dan mengembalikan PNG transparan. Ini adalah fitur yang sama dengan halaman "Hapus latar" di aplikasi web.

Biaya kredit: 1

Metode dan Path

POST /public/v1/image-tune/remove-background

Autentikasi

Lihat halaman autentikasi. Token Bearer diperlukan.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Field Permintaan

Kirim permintaan sebagai multipart/form-data.

Nama Field	Tipe	Wajib	Deskripsi
image	file	Ya	Gambar yang latar belakangnya akan dihapus (PNG atau JPEG)

Respons

Respons Berhasil (200 OK):

{
  "job_id": "uuid-string"
}

Field	Tipe	Deskripsi
job_id	string	Pengidentifikasi unik untuk job yang dibuat. Gunakan Get Job Status untuk melihat hasil

Aturan Error / Validasi

Kondisi	Status HTTP	Pesan Error
Gambar bukan file PNG atau JPEG yang valid	400	"Invalid image file"
API key tidak valid	401	"Invalid API key"
Field hilang	422	Error validasi

Perilaku Job Async

Endpoint ini membuat job asynchronous. Endpoint akan segera mengembalikan job_id, dan penghapusan latar berjalan di latar belakang.

Metode Polling:

Simpan job_id yang diterima dari respons
Poll GET /public/v1/job/{job_id} untuk memeriksa status
Saat status menjadi Succeed, lihat gambar hasil pada image_urls

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL:

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/remove-background" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png"

Tujuan​

Metode dan Path​

Autentikasi​

Field Permintaan​

Respons​

Aturan Error / Validasi​

Perilaku Job Async​

Contoh Permintaan​