Specifiche tecniche di bria/expand-image
| Specifiche | Dettagli |
|---|---|
| Model ID | bria/expand-image |
| Provider / model family | Bria Expand, un modello di espansione dell'immagine e outpainting di Bria |
| Primary task | Ampliare un'immagine oltre i suoi bordi originali generando nuovi pixel per adattarla a una composizione più ampia o più alta |
| API operation type | Endpoint di modifica delle immagini / outpainting |
| Official Bria endpoint | POST /v2/image/edit/expand sull'API di modifica immagini di Bria |
| Input image formats | JPEG, JPG, PNG, WEBP; l'immagine può essere fornita come base64 o come URL pubblicamente accessibile |
| Output behavior | Restituisce un URL dell'immagine espansa; Bria v2 può restituire risultati sincroni o risposte asincrone con request_id e status_url in base alla modalità di elaborazione |
| Aspect ratio controls | Supporta rapporti predefiniti come 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16 e 16:9, oltre a rapporti personalizzati in virgola mobile da 0.5 a 3.0 |
| Canvas controls | Può utilizzare canvas_size, original_image_size e original_image_location espliciti quando non si usa aspect_ratio |
| Canvas limits | L'area consigliata della canvas è entro 5000×5000 pixel totali, con un'area massima consentita di 25 milioni di pixel per il dimensionamento esplicito della canvas |
| Prompt support | Un prompt opzionale in inglese può guidare l'espansione; se omesso, Bria può generare automaticamente un prompt a partire dall'immagine di input |
| Moderation options | Supporta la moderazione del prompt e i controlli di moderazione dell'output visivo nell'API di Bria |
| Commercial positioning | Bria descrive il modello come addestrato esclusivamente su dati con licenza per un uso commerciale sicuro |
Che cos'è bria/expand-image?
bria/expand-image è l'identificatore di piattaforma di CometAPI per il modello di espansione dell'immagine di Bria, progettato per estendere un'immagine esistente oltre i suoi confini originali preservando la continuità visiva. In pratica, è un modello di outpainting: invece di ritagliare un'immagine per adattarla a un nuovo formato, genera contenuti aggiuntivi intorno all'immagine originale affinché il risultato finale corrisponda a un rapporto d'aspetto target o al layout della canvas.
Questo modello è pensato per flussi di lavoro come l'adattamento di creatività per posizionamenti sui social media, la conversione di immagini in verticale in banner orizzontali, la creazione di sfondo aggiuntivo attorno a un soggetto o il reframing di visual di prodotto e marketing senza dover modificare manualmente ogni asset. La documentazione di Bria colloca questa funzionalità all'interno della sua suite di API per l'editing delle immagini, insieme a strumenti come modifica dello sfondo, cancellazione, riempimento generativo e upscaling.
Un aspetto rilevante del posizionamento di Bria è la prontezza per l'impresa e l'uso commerciale. Bria afferma che i suoi modelli sono addestrati su dati con licenza e li propone come adatti a un utilizzo commerciale a rischio ridotto, fattore importante per i team che costruiscono pipeline di design, brand o ecommerce in produzione.
Caratteristiche principali di bria/expand-image
- Outpainting di immagini di alta qualità: Estende le immagini oltre i loro bordi generando nuovi pixel che proseguono la scena originale, invece di semplicemente deformare o ritagliare l'immagine di origine.
- Adattamento del rapporto d'aspetto: Consente di espandere a formati target comuni come
16:9,9:16,1:1e altri, utile per riutilizzare un asset su più canali. - Posizionamento preciso sulla canvas: Supporta
canvas_size,original_image_sizeeoriginal_image_locationcosì che gli sviluppatori possano controllare esattamente dove l'immagine originale si colloca nella nuova composizione. - Guida tramite prompt (opzionale): Accetta un prompt testuale per orientare le aree generate; se non viene fornito, il servizio può ricavarlo automaticamente dall'immagine.
- Metodi di input flessibili: Accetta dati immagine codificati in base64 o un URL pubblico dell'immagine, semplificando l'integrazione con app web, pipeline di asset e sistemi di automazione.
- Flusso API adatto alla produzione: Bria v2 supporta l'elaborazione asincrona con
request_idestatus_url, utile per job di immagine più lunghi e per l'orchestrazione backend. - Opzioni di moderazione integrate: Include impostazioni di moderazione del prompt e dell'output per aiutare i team a far rispettare le policy nelle integrazioni di produzione.
- Posizionamento per uso commerciale: Bria promuove il modello come addestrato su dati con licenza per un'adozione commerciale più sicura, rilevante per le operation di contenuti enterprise.
Come accedere e integrare bria/expand-image
Passaggio 1: registrazione per la chiave API
Per iniziare, registrati su CometAPI e genera la tua chiave API dal dashboard. Una volta ottenuta, puoi autenticare le richieste verso il modello bria/expand-image e qualsiasi altro modello supportato sulla piattaforma.
Passaggio 2: invia richieste all'API di bria/expand-image
Usa l'endpoint compatibile con Bria di CometAPI: 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
}'
Passaggio 3: recupera e verifica i risultati
L'API restituisce un ID attività. Effettua polling su GET /bria/{task_id} per verificare lo stato di elaborazione e recuperare l'URL dell'immagine di output al termine.