Gambar ulang V2

Tujuan

Menggambar ulang sebagian gambar dengan AI berdasarkan prompt. Unggah gambar dan jelaskan bagian yang harus digambar ulang. Ini adalah fitur yang sama dengan tab V2 pada halaman "Cat ulang gambar" di aplikasi web (tab default).

Biaya kredit: 3

Metode dan Path

POST /public/v1/image-tune/inpaint/v2

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	File gambar asli yang akan digambar ulang (PNG atau JPEG)
prompt	string	Ya	Bagian mana yang harus digambar ulang? Prompt dikirim apa adanya

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

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 proses gambar ulang berjalan di latar belakang.

Metode Polling:

1. Simpan job_id yang diterima dari respons
2. Poll GET /public/v1/job/{job_id} untuk memeriksa status
3. 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/inpaint/v2" \
-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"
}