Inpaint V2

Tujuan

Endpoint ini secara alami mengubah bagian tertentu dari gambar dengan AI. Memodifikasi area yang ditentukan berdasarkan gambar yang diunggah dan prompt untuk menghasilkan output yang diinginkan.

Metode dan Path

• HTTP Method: POST
• Path: /public/v1/image-tune/inpaint/v2

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 inpaint (PNG, JPG, JPEG, dll.)
prompt	string	Wajib	Prompt teks yang menjelaskan konten yang akan diinpaint
quality	string	Wajib	Tingkat kualitas. Nilai yang diizinkan: standard, pro

Panduan Prompt

• Jelaskan secara spesifik area yang akan diinpaint dan hasil yang diinginkan
• Contoh: "Ubah latar belakang menjadi langit biru", "Hapus objek di sudut kanan atas"

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 inpaint aktual berlangsung di latar belakang.

Alur Pekerjaan:

1. Kirim file gambar dan prompt, job_id segera dikembalikan
2. Pemrosesan inpaint 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 hasil di image_urls

Interval Polling: 1-2 detik direkomendasikan

Contoh Permintaan

cURL

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Ubah latar belakang menjadi langit biru" \
-F "quality=standard"

Contoh Respons

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