bria/increase-resolution

Spesifikasi Teknis bria/increase-resolution

Apa itu bria/increase-resolution?

bria/increase-resolution adalah endpoint model upscaling gambar milik Bria untuk meningkatkan resolusi gambar tanpa membayangkan ulang atau meregenerasi konten dasarnya. Bria menggambarkan endpoint ini sebagai kapabilitas peningkatan resolusi khusus yang mempertahankan gambar asli alih-alih menambahkan detail baru yang diciptakan, sehingga cocok untuk alur kerja yang memerlukan pembesaran yang lebih bersih dengan fidelitas visual yang dapat diprediksi.

Model ini merupakan bagian dari rangkaian Image Editing API Bria yang lebih luas, yang mencakup endpoint khusus tugas untuk operasi seperti perluasan, pengeditan latar belakang, masking, dan penghapusan. Di dalam jajaran tersebut, bria/increase-resolution adalah opsi khusus untuk upscaling yang sederhana.

Karena Bria membedakan rute ini dari endpoint “Enhance Image” yang terpisah, bria/increase-resolution paling tepat dipahami sebagai alat super-resolution yang mengutamakan pelestarian: alat ini memperbesar resolusi gambar menggunakan metode upscaling khusus, sementara rute enhancement ditujukan untuk meregenerasi tekstur yang lebih kaya atau menambah kekayaan visual.

Fitur utama bria/increase-resolution

• Peningkatan skala resolusi: Menskalakan gambar input dengan pengali yang didukung 2x atau 4x, memberikan pengembang jalur sederhana menuju keluaran beresolusi lebih tinggi untuk aset yang sudah ada.
• Perilaku yang mempertahankan konten: Dirancang untuk mempertahankan konten gambar asli alih-alih meregenerasi atau mengubahnya secara kreatif, yang berguna untuk pipeline gambar yang sensitif terhadap merek dan deterministik.
• Dukungan keluaran berukuran besar: Mendukung upscaling hingga total area keluaran maksimum 8192 × 8192 piksel, memungkinkan penyajian beresolusi tinggi untuk banyak kasus penggunaan produksi.
• Penerimaan input yang fleksibel: Menerima URL gambar yang dapat diakses publik atau payload gambar yang dikodekan Base64, memudahkan integrasi dengan alur kerja media terhosting maupun unggahan langsung.
• Kompatibilitas format yang luas: Bekerja dengan input JPEG, JPG, PNG, dan WEBP, sementara dokumentasi endpoint Bria juga mencatat batasan terkait mode berkas/warna yang didukung dan respons 415 untuk kasus yang tidak didukung.
• Pelestarian transparansi: Menyertakan opsi preserve_alpha sehingga gambar dengan saluran alfa dapat mempertahankan piksel transparan dan sebagian transparan pada keluaran.
• Pemrosesan yang mendukung asinkron: Mendukung pemrosesan asinkron secara default, mengembalikan URL status untuk melacak pekerjaan berdurasi panjang, serta menawarkan mode sinkron bila diperlukan.
• Kontrol moderasi bawaan: Bria mendokumentasikan moderasi gambar input dan output untuk rute ini, membantu tim menegakkan penggunaan produksi yang lebih aman.

Cara mengakses dan mengintegrasikan bria/increase-resolution

Langkah 1: Daftar untuk Kunci API

Untuk mengakses API bria/increase-resolution, terlebih dahulu buat akun di CometAPI dan hasilkan kunci API dari dasbor. Setelah masuk, simpan kunci tersebut dengan aman sebagai variabel lingkungan seperti COMETAPI_API_KEY. Kunci ini akan digunakan untuk mengautentikasi semua permintaan ke bria/increase-resolution.

Langkah 2: Kirim Permintaan ke API bria/increase-resolution

Gunakan endpoint CometAPI yang kompatibel dengan Bria pada POST /bria/image/edit/increase-resolution.

curl https://api.cometapi.com/bria/image/edit/increase-resolution \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A paper boat floating on calm water at sunrise.",
    "num_results": 1
  }'

Langkah 3: Ambil dan Verifikasi Hasil

API mengembalikan ID tugas. Lakukan polling ke GET /bria/{task_id} untuk memeriksa status pemrosesan dan mengambil URL gambar keluaran saat selesai.