Vai al contenuto principale
POST
/
bria
/
text-to-image
Generate Bria images
curl --request POST \
  --url https://api.cometapi.com/bria/text-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}
Genera immagini commercialmente sicure a partire da un semplice prompt testuale. Per una prima richiesta su CometAPI, invia prompt, mantieni num_results su 1 e inizia con aspect_ratio: "1:1" a meno che tu non conosca già il layout finale di cui hai bisogno.

Usa questo endpoint quando

  • Vuoi un’immagine finale in una sola chiamata
  • Non hai bisogno di maschere, input immagine o polling delle attività
  • Vuoi un percorso Bria fotorealistico più semplice da rendere operativo tramite CometAPI

Inizia con questa richiesta

  • Mantieni il prompt breve e concreto
  • Usa num_results: 1 per il tuo primo smoke test
  • Inizia con aspect_ratio: "1:1" a meno che il layout di destinazione non sia già definito
  • Scarica tempestivamente gli URL restituiti se hai bisogno di una conservazione a lungo termine

Comportamento della risposta su CometAPI

La documentazione ufficiale di Bria descrive una pipeline di generazione più ampia e tratta i flussi di stato asincroni. Su CometAPI, questo endpoint usa una richiesta JSON semplificata e, negli attuali smoke test, ha restituito immediatamente un array result finale anziché un request_id più status_url.
CometAPI fa da proxy alle capacità di Bria invece di rispecchiare l’API pubblica di Bria campo per campo. Usa le strutture di richiesta e risposta mostrate nel riferimento API e nel Playground di questa pagina come fonte di verità per l’integrazione.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
prompt
string
obbligatorio

English text prompt for image generation.

Esempio:

"A paper boat floating on calm water at sunrise."

num_results
integer
predefinito:1

Number of images to generate. Use 1 for the simplest integration test.

aspect_ratio
enum<string>
predefinito:1:1

Requested output aspect ratio.

Opzioni disponibili:
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9
seed
integer

Optional seed for reproducible results.

negative_prompt
string

Optional exclusions for the generated image.

steps_num
integer
predefinito:30

Optional refinement step count.

text_guidance_scale
integer
predefinito:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Opzioni disponibili:
photography,
art
prompt_enhancement
boolean
predefinito:false

Optional prompt enhancement switch.

enhance_image
boolean
predefinito:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
predefinito:false

Optional moderation switch.

ip_signal
boolean
predefinito:false

Optional IP warning flag.

sync
boolean
predefinito:false

Optional sync hint. Current CometAPI smoke tests returned final results immediately without setting this field.

Risposta

200 - application/json

Image generation result.

result
object[]
obbligatorio