bria/increase-resolution

Spesifikasi Teknikal bagi bria/increase-resolution

Apakah bria/increase-resolution?

bria/increase-resolution ialah titik akhir model pembesaran resolusi imej milik Bria untuk meningkatkan resolusi imej tanpa mereka-reka atau menjana semula kandungan asas. Bria menerangkan laluan ini sebagai keupayaan khusus untuk meningkatkan resolusi yang memelihara imej asal dan bukannya menambah butiran baharu yang direka, menjadikannya sesuai untuk aliran kerja yang memerlukan pembesaran lebih bersih dengan kesetiaan visual yang boleh dijangka.

Model ini sebahagian daripada rangkaian API Penyuntingan Imej Bria yang lebih luas, termasuk titik akhir khusus tugas untuk operasi seperti pengembangan, penyuntingan latar belakang, pemaskaan dan pemadaman. Dalam barisan itu, bria/increase-resolution ialah pilihan khusus untuk pembesaran terus.

Memandangkan Bria membezakan laluan ini daripada titik akhir “Enhance Image” yang berasingan, bria/increase-resolution paling sesuai difahami sebagai alat super-resolusi berorientasikan pemeliharaan: ia membesarkan resolusi imej menggunakan kaedah penskalaan khusus, manakala laluan peningkatan tersebut bertujuan untuk menjana semula tekstur yang lebih kaya atau menambah kekayaan visual.

Ciri utama bria/increase-resolution

• Pembesaran resolusi: Membesarkan imej input dengan pengganda 2x atau 4x yang disokong, memberikan laluan mudah kepada pembangun untuk keluaran beresolusi lebih tinggi bagi aset sedia ada.
• Kelakuan yang memelihara kandungan: Direka untuk mengekalkan kandungan imej asal dan bukannya menjana semula atau mengubahnya secara kreatif, berguna untuk saluran paip imej yang sensitif terhadap jenama dan deterministik.
• Sokongan keluaran besar: Menyokong pembesaran sehingga jumlah kawasan keluaran 8192 × 8192 piksel, membolehkan penghantaran beresolusi tinggi bagi banyak kes penggunaan produksi.
• Pengambilan input yang fleksibel: Menerima sama ada URL imej yang boleh diakses awam atau payload imej berkod Base64, memudahkan integrasi dengan media dihoskan dan aliran muat naik terus.
• Keserasian format yang luas: Berfungsi dengan input JPEG, JPG, PNG dan WEBP, sementara dokumentasi titik akhir Bria turut menyatakan kekangan sekitar mod fail/warna yang disokong dan respons 415 untuk kes yang tidak disokong.
• Pemeliharaan ketelusan: Menyertakan pilihan preserve_alpha agar imej dengan saluran alfa boleh mengekalkan piksel lutsinar dan separa lutsinar dalam keluaran.
• Pemprosesan mesra asinkron: Menyokong pemprosesan asinkron secara lalai, memulangkan URL status untuk menjejak tugasan jangka panjang, dan turut menawarkan mod segerak apabila diperlukan.
• Kawalan moderasi terbina dalam: Bria mendokumenkan moderasi imej input dan imej output untuk laluan ini, membantu pasukan menguatkuasakan penggunaan produksi yang lebih selamat.

Cara mengakses dan mengintegrasikan bria/increase-resolution

Langkah 1: Daftar untuk Kunci API

Untuk mengakses API bria/increase-resolution, mula-mula cipta akaun di CometAPI dan jana kunci API anda daripada papan pemuka. Selepas log masuk, simpan kunci tersebut dengan selamat sebagai pemboleh ubah persekitaran seperti COMETAPI_API_KEY. Kunci ini akan digunakan untuk mengesahkan semua permintaan ke bria/increase-resolution.

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

Gunakan titik akhir serasi Bria milik CometAPI di 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: Dapatkan dan Sahkan Keputusan

API memulangkan ID tugasan. Lakukan pertanyaan berkala ke GET /bria/{task_id} untuk memeriksa status pemprosesan dan dapatkan URL imej keluaran apabila selesai.