POST /image-tune/inpaint/v1

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. Ini adalah fitur yang sama dengan tab V1 pada halaman "Cat ulang gambar" di aplikasi web (aplikasi web membuka tab V2 secara default).

Biaya kredit: 5

Metode dan Path

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

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 yang akan digambar ulang (PNG atau JPEG)
prompt	string	Wajib	Prompt teks yang menjelaskan apa yang akan digambar ulang

Panduan Prompt

• Jelaskan secara detail area yang akan digambar ulang dan hasil yang diinginkan
• Contoh: "Change background to blue sky", "Remove object in upper right corner"

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

Alur Pekerjaan:

1. Kirim file gambar dan prompt, job_id segera dikembalikan
2. Pemrosesan gambar ulang 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/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Change background to blue sky"

Contoh Respons

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