> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Genera un'immagine Bria
> Usa CometAPI Bria POST /bria/text-to-image per generare immagini fotorealistiche da 1MP a partire da testo, con miglioramenti e rapporti di aspetto flessibili.
Genera immagini sicure per uso commerciale 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 questa route quando
* Vuoi un'immagine finale in una sola chiamata
* Non hai bisogno di maschere, input immagine o polling del task
* 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 la tua prima richiesta
* 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 prolungata
## Comportamento della risposta su CometAPI
La documentazione ufficiale di Bria descrive una pipeline di generazione più ampia e parla di flussi di stato asincroni. Su CometAPI, questa route usa una richiesta JSON semplificata e restituisce immediatamente un array `result` finale invece di 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.
## OpenAPI
````yaml api/openapi/image/bria/post-generate-image.openapi.json POST /bria/text-to-image
openapi: 3.1.0
info:
title: Generate Image API
version: 1.0.0
description: >-
Generate Bria text-to-image outputs through CometAPI. This route returns
final image URLs directly.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/bria/text-to-image:
post:
summary: Generate Bria images
description: >-
Create one or more Bria images from a text prompt. For the most
predictable first request, keep num_results at 1 and use a square aspect
ratio.
operationId: generate_image
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- prompt
properties:
prompt:
type: string
description: English text prompt for image generation.
example: A paper boat floating on calm water at sunrise.
num_results:
type: integer
description: >-
Number of images to generate. Use 1 for the simplest
integration test.
default: 1
aspect_ratio:
type: string
description: Requested output aspect ratio.
enum:
- '1:1'
- '2:3'
- '3:2'
- '3:4'
- '4:3'
- '4:5'
- '5:4'
- '9:16'
- '16:9'
default: '1:1'
seed:
type: integer
description: Optional seed for reproducible results.
negative_prompt:
type: string
description: Optional exclusions for the generated image.
steps_num:
type: integer
description: Optional refinement step count.
default: 30
text_guidance_scale:
type: integer
description: Optional prompt adherence setting.
default: 5
medium:
type: string
description: Optional visual medium.
enum:
- photography
- art
prompt_enhancement:
type: boolean
description: Optional prompt enhancement switch.
default: false
enhance_image:
type: boolean
description: Optional image detail enhancement switch.
default: false
prompt_content_moderation:
type: boolean
description: Optional moderation switch.
default: false
ip_signal:
type: boolean
description: Optional IP warning flag.
default: false
sync:
type: boolean
description: >-
Optional sync hint. CometAPI returns final results
immediately without setting this field.
default: false
default:
prompt: A paper boat floating on calm water at sunrise.
num_results: 1
aspect_ratio: '1:1'
examples:
Validated request:
summary: Validated request
value:
prompt: A paper boat floating on calm water at sunrise.
num_results: 1
aspect_ratio: '1:1'
responses:
'200':
description: Image generation result.
content:
application/json:
schema:
type: object
required:
- result
properties:
result:
type: array
items:
type: object
required:
- urls
- seed
- uuid
properties:
urls:
type: array
items:
type: string
seed:
type: integer
uuid:
type: string
example:
result:
- urls:
- https://example.com/generated.png
seed: 278741175
uuid: 27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175
example:
result:
- urls:
- >-
https://temp.bria.ai/api/generate_image/A_paper_boat_..._seed_934469972.png
seed: 934469972
uuid:
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/bria/text-to-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
}'
- lang: Python
label: Default
source: >
import os
import requests
response = requests.post(
"https://api.cometapi.com/bria/text-to-image",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
},
)
print(response.json()) # the route responds synchronously with
result[].urls
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/bria/text-to-image", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
}),
});
console.log(await response.json()); // the route responds
synchronously with result[].urls
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````