Spesifikasi Teknis bria/expand-image
| Spesifikasi | Rincian |
|---|---|
| ID Model | bria/expand-image |
| Penyedia / keluarga model | Bria Expand, model perluasan gambar dan outpainting dari Bria |
| Tugas utama | Memperluas gambar melampaui batas aslinya dengan menghasilkan piksel baru agar sesuai dengan komposisi yang lebih lebar atau lebih tinggi |
| Jenis operasi API | Endpoint penyuntingan gambar / outpainting |
| Endpoint resmi Bria | POST /v2/image/edit/expand pada API penyuntingan gambar Bria |
| Format gambar masukan | JPEG, JPG, PNG, WEBP; gambar dapat diberikan sebagai base64 atau URL yang dapat diakses publik |
| Perilaku keluaran | Mengembalikan URL gambar yang telah diperluas; Bria v2 dapat mengembalikan hasil sinkron atau respons asinkron dengan request_id dan status_url bergantung pada mode pemrosesan |
| Kontrol rasio aspek | Mendukung rasio preset seperti 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, dan 16:9, serta rasio float kustom dari 0.5 hingga 3.0 |
| Kontrol kanvas | Dapat menggunakan canvas_size, original_image_size, dan original_image_location eksplisit saat tidak menggunakan aspect_ratio |
| Batas kanvas | Area kanvas yang direkomendasikan berada dalam total area 5000×5000 piksel, dengan area maksimum yang diizinkan 25 juta piksel untuk penentuan ukuran kanvas eksplisit |
| Dukungan prompt | Prompt opsional berbahasa Inggris dapat memandu perluasan; jika diabaikan, Bria dapat menghasilkan prompt secara otomatis dari gambar masukan |
| Opsi moderasi | Mendukung moderasi prompt dan kontrol moderasi keluaran visual di API Bria |
| Posisi komersial | Bria menggambarkan model ini dilatih secara eksklusif pada data berlisensi untuk penggunaan komersial yang aman |
Apa itu bria/expand-image?
bria/expand-image adalah pengidentifikasi platform milik CometAPI untuk model perluasan gambar dari Bria, yang dirancang untuk memperluas gambar yang ada melampaui batas aslinya sambil menjaga kontinuitas visual. Dalam praktiknya, ini adalah model outpainting: alih-alih memotong gambar agar sesuai dengan format baru, model ini menghasilkan konten tambahan di sekitar gambar asli sehingga hasil akhir sesuai dengan rasio aspek target atau tata letak kanvas.
Model ini ditujukan untuk alur kerja seperti menyesuaikan materi kreatif untuk penempatan media sosial, mengonversi gambar potret menjadi banner lanskap, membuat latar tambahan di sekitar subjek, atau membingkai ulang visual produk dan pemasaran tanpa menyunting setiap aset secara manual. Dokumentasi Bria menempatkan kapabilitas ini di dalam rangkaian API penyuntingan gambar yang lebih luas, berdampingan dengan alat seperti penyuntingan latar belakang, penghapusan, pengisian generatif, dan peningkatan resolusi.
Bagian penting dari posisi Bria adalah kesiapan tingkat enterprise dan komersial. Bria menyatakan bahwa model-modelnya dilatih pada data berlisensi dan dipasarkan sebagai cocok untuk penggunaan komersial dengan risiko lebih rendah, yang dapat penting bagi tim yang membangun alur produksi desain, merek, atau ecommerce.
Fitur utama bria/expand-image
- Outpainting gambar berkualitas tinggi: Memperluas gambar melampaui batasnya dengan menghasilkan piksel baru yang meneruskan adegan asli, bukan sekadar meregangkan atau memotong sumber.
- Adaptasi rasio aspek: Memungkinkan perluasan ke format target umum seperti
16:9,9:16,1:1, dan lainnya, sehingga berguna untuk memanfaatkan satu aset di berbagai kanal. - Penempatan kanvas yang presisi: Mendukung
canvas_size,original_image_size, danoriginal_image_locationsehingga pengembang dapat mengontrol secara tepat posisi gambar asli di dalam komposisi baru. - Panduan prompt opsional: Menerima prompt teks untuk mengarahkan area yang dihasilkan; jika tidak diberikan, layanan dapat secara otomatis menurunkan prompt dari gambar.
- Metode input yang fleksibel: Menerima data gambar yang dikodekan base64 atau URL gambar yang dapat diakses publik, memudahkan integrasi dengan aplikasi web, pipeline aset, dan otomatisasi.
- Alur API ramah produksi: Bria v2 mendukung pemrosesan asinkron dengan
request_iddanstatus_url, yang berguna untuk pekerjaan gambar berdurasi lebih lama dan orkestrasi backend. - Opsi moderasi bawaan: Menyertakan pengaturan moderasi prompt dan keluaran untuk membantu tim menegakkan kontrol kebijakan dalam integrasi produksi.
- Posisi penggunaan komersial: Bria memasarkan model ini sebagai dilatih pada data berlisensi untuk penerapan komersial yang lebih aman, relevan bagi operasi konten enterprise.
Cara mengakses dan mengintegrasikan bria/expand-image
Langkah 1: Daftar untuk Kunci API
Untuk memulai, daftar di CometAPI dan buat kunci API dari dasbor. Setelah Anda memiliki kunci API, Anda dapat mengautentikasi permintaan ke model bria/expand-image dan model lain yang didukung di platform.
Langkah 2: Kirim permintaan ke API bria/expand-image
Gunakan endpoint kompatibel Bria milik CometAPI di POST /bria/image/edit/expand-image.
curl https://api.cometapi.com/bria/image/edit/expand-image \
-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 akan mengembalikan ID tugas. Lakukan polling ke GET /bria/{task_id} untuk memeriksa status pemrosesan dan mengambil URL gambar keluaran saat selesai.