Tingkatkan kualitas

Tujuan

Endpoint ini meningkatkan kualitas gambar yang diunggah pada resolusi yang lebih tinggi. Endpoint memperbesar gambar asli ke resolusi 1K, 2K, atau 4K untuk menghasilkan gambar yang lebih tajam dan berkualitas lebih tinggi. Ini adalah fitur yang sama dengan halaman "Tingkatkan kualitas" di aplikasi web, dengan 2K dipilih secara default.

Biaya kredit: 5 (1K), 7 (2K), 10 (4K)

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

Nilai Scale

• "1K": Tingkatkan ke resolusi 1024px
• "2K": Tingkatkan ke resolusi 2048px
• "4K": Tingkatkan ke resolusi 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 pemrosesan peningkatan kualitas aktual berlangsung di latar belakang.

Alur Pekerjaan:

1. Kirim file gambar dan parameter scale, job_id segera dikembalikan
2. Pemrosesan 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"
}