Tingkatkan Kualitas

Tujuan

Endpoint ini meningkatkan kualitas gambar yang diunggah ke resolusi tinggi. Memperluas gambar asli ke resolusi 1K, 2K, atau 4K untuk menghasilkan gambar yang lebih tajam dan berkualitas tinggi.

Metode dan Path

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

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 diupscale (PNG, JPG, JPEG, dll.)
scale	string	Wajib	Resolusi target. Nilai yang mungkin: "1K", "2K", "4K"

Nilai Scale

• "1K": Upscale ke resolusi berbasis 1024px
• "2K": Upscale ke resolusi berbasis 2048px
• "4K": Upscale ke resolusi berbasis 4096px

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 atau nilai scale tidak valid

Perilaku Pekerjaan Asinkron

Endpoint ini diproses secara asinkron. Ini segera mengembalikan job_id setelah permintaan, dan proses peningkatan kualitas aktual berlangsung di latar belakang.

Alur Pekerjaan:

1. Kirim file gambar dan parameter scale, job_id segera dikembalikan
2. Proses peningkatan kualitas 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/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"

Contoh Respons

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