bria/increase-resolution

Specifiche tecniche di bria/increase-resolution

Che cos'è bria/increase-resolution?

bria/increase-resolution è l'endpoint di upscaling delle immagini di Bria per aumentare la risoluzione senza reimmaginare o rigenerare il contenuto sottostante. Bria descrive questa route come una funzionalità dedicata di aumento della risoluzione che preserva l'immagine originale invece di aggiungere dettagli inventati, rendendola adatta a flussi che necessitano di un ingrandimento più pulito con fedeltà visiva prevedibile.

Questo modello fa parte della più ampia suite di API di Image Editing di Bria, che include endpoint specifici per attività come espansione, modifica dello sfondo, mascheratura e cancellazione. In questo contesto, bria/increase-resolution è l'opzione specializzata per l'upscaling diretto.

Poiché Bria distingue questa route dal suo endpoint separato “Enhance Image”, bria/increase-resolution va inteso come uno strumento di super-risoluzione incentrato sulla preservazione: aumenta la risoluzione utilizzando un metodo di upscaling dedicato, mentre la route di enhancement è pensata per rigenerare trame più ricche o aggiungere ricchezza visiva.

Funzionalità principali di bria/increase-resolution

• Upscaling della risoluzione: Aumenta la risoluzione delle immagini in input con moltiplicatori supportati di 2x o 4x, offrendo agli sviluppatori un percorso semplice verso output a risoluzione più alta per asset esistenti.
• Comportamento di preservazione del contenuto: Progettato per preservare il contenuto originale dell'immagine invece di rigenerarlo o modificarlo creativamente, utile per pipeline di immagini deterministiche e sensibili al brand.
• Supporto per output di grandi dimensioni: Supporta l'upscaling fino a una massima area di output di 8192 × 8192 pixel, consentendo consegne ad alta risoluzione per molti casi d'uso in produzione.
• Ingestione flessibile dell’input: Accetta sia URL di immagini pubblicamente accessibili sia payload di immagini codificate in Base64, facilitando l’integrazione con flussi basati su media ospitati o caricamenti diretti.
• Ampia compatibilità di formati: Funziona con input JPEG, JPG, PNG e WEBP, mentre la documentazione dell’endpoint di Bria segnala anche vincoli relativi ai formati di file/modalità colore supportati e risposte 415 per i casi non supportati.
• Preservazione della trasparenza: Include l'opzione preserve_alpha affinché le immagini con canali alpha conservino i pixel trasparenti e parzialmente trasparenti nell'output.
• Elaborazione compatibile con l’asincrono: Supporta l’elaborazione asincrona per impostazione predefinita, restituendo un URL di stato per tracciare job di lunga durata, offrendo anche la modalità sincrona quando necessario.
• Controlli di moderazione integrati: Bria documenta la moderazione sia dell’immagine di input sia di quella di output per questa route, aiutando i team a garantire un uso più sicuro in produzione.

Come accedere e integrare bria/increase-resolution

Passaggio 1: Registrati per ottenere la chiave API

Per accedere all’API bria/increase-resolution, crea innanzitutto un account su CometAPI e genera la tua chiave API dalla dashboard. Dopo l’accesso, conserva la chiave in modo sicuro come variabile d’ambiente, ad esempio COMETAPI_API_KEY. Questa chiave verrà utilizzata per autenticare tutte le richieste a bria/increase-resolution.

Passaggio 2: Invia richieste all’API bria/increase-resolution

Usa l’endpoint di CometAPI compatibile con Bria all’indirizzo 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
  }'

Passaggio 3: Recupera e verifica i risultati

L’API restituisce un ID attività. Interroga GET /bria/{task_id} per verificare lo stato dell’elaborazione e recuperare l’URL dell’immagine di output al completamento.