Saltar al contenido principal
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 imágenes seguras para uso comercial a partir de un prompt de texto simple. Para una primera solicitud en CometAPI, envía prompt, mantén num_results en 1 y comienza con aspect_ratio: "1:1" a menos que ya sepas el diseño final que necesitas.

Usa esta ruta cuando

  • Quieres una imagen terminada en una sola llamada
  • No necesitas máscaras, imágenes de entrada ni sondeo de tareas
  • Quieres una ruta fotorrealista de Bria que sea más fácil de poner en producción mediante CometAPI

Comienza con esta solicitud

  • Mantén el prompt corto y concreto
  • Usa num_results: 1 para tu primera prueba rápida
  • Comienza con aspect_ratio: "1:1" a menos que el diseño de destino ya esté definido
  • Descarga las URLs devueltas rápidamente si necesitas conservarlas durante mucho tiempo

Comportamiento de la respuesta en CometAPI

La documentación oficial de Bria describe un pipeline de generación más amplio y analiza flujos de estado asíncronos. En CometAPI, esta ruta usa una solicitud JSON simplificada y, en las pruebas rápidas actuales, devolvió inmediatamente un array result final en lugar de un request_id más status_url.
CometAPI actúa como proxy de la capacidad de Bria en lugar de reflejar la API pública de Bria campo por campo. Usa las formas de solicitud y respuesta que se muestran en la referencia de API y el Playground de esta página como fuente de verdad para la integración.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
prompt
string
requerido

English text prompt for image generation.

Ejemplo:

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

num_results
integer
predeterminado:1

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

aspect_ratio
enum<string>
predeterminado:1:1

Requested output aspect ratio.

Opciones disponibles:
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
predeterminado:30

Optional refinement step count.

text_guidance_scale
integer
predeterminado:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Opciones disponibles:
photography,
art
prompt_enhancement
boolean
predeterminado:false

Optional prompt enhancement switch.

enhance_image
boolean
predeterminado:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
predeterminado:false

Optional moderation switch.

ip_signal
boolean
predeterminado:false

Optional IP warning flag.

sync
boolean
predeterminado:false

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

Respuesta

200 - application/json

Image generation result.

result
object[]
requerido