Pisahkan Lapisan

Tujuan

Endpoint ini memisahkan gambar yang diunggah menjadi lapisan. Mengekstrak elemen tertentu dari gambar berdasarkan kata kunci menjadi lapisan individual.

Metode dan Path

• HTTP Method: POST
• Path: /public/v1/image-tune/split-layer

Autentikasi

Endpoint ini memerlukan autentikasi Bearer Token. Lihat Panduan Autentikasi untuk detailnya.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Field Permintaan

Form Data (multipart/form-data)

Nama Field	Tipe	Wajib	Deskripsi
image	file	Wajib	File gambar asli untuk dipisahkan menjadi lapisan (PNG, JPG, JPEG, dll.)
keyword	string	Wajib	Kata kunci yang menentukan elemen yang akan dipisahkan

Panduan Kata Kunci

• Masukkan kata kunci yang menjelaskan elemen gambar yang ingin dipisahkan
• Contoh: "arm", "body", "leg"

Respons

JobIdResponse

Nama Field	Tipe	Deskripsi
job_id	UUID	Pengidentifikasi unik pekerjaan yang dibuat. Ambil status pekerjaan dengan ID ini

Aturan Kesalahan / Validasi

Kode Status HTTP	Situasi Kesalahan	Deskripsi
400 Bad Request	Invalid image file	Invalid image file
401 Unauthorized	Gagal autentikasi	Kunci API tidak valid atau header autentikasi hilang
404 Not Found	Pengguna tidak ditemukan	Tidak dapat menemukan pengguna yang terhubung ke kunci API
422 Unprocessable Entity	Validasi gagal	Field wajib hilang

Perilaku Pekerjaan Asinkron

Endpoint ini diproses secara asinkron. Ini segera mengembalikan job_id setelah permintaan, dan pemrosesan pemisahan lapisan aktual berlangsung di latar belakang.

Alur Pekerjaan:

1. Kirim file gambar dan kata kunci, job_id segera dikembalikan
2. Pemrosesan pemisahan lapisan berlangsung di latar belakang
3. Lakukan polling ke endpoint GET /job/{job_id} untuk memeriksa status
4. Ketika status berubah menjadi Succeed, periksa URL gambar lapisan yang dipisahkan di image_urls

Interval Polling: 1-2 detik direkomendasikan

Contoh Permintaan

cURL

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

Contoh Respons

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}