Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Generate Bria images

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.

post/bria/text-to-image

Request body

promptstring required

English text prompt for image generation.

num_resultsinteger

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

aspect_ratio'1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9'

Requested output aspect ratio.

seedinteger

Optional seed for reproducible results.

negative_promptstring

Optional exclusions for the generated image.

steps_numinteger

Optional refinement step count.

text_guidance_scaleinteger

Optional prompt adherence setting.

medium'photography' | 'art'

Optional visual medium.

prompt_enhancementboolean

Optional prompt enhancement switch.

enhance_imageboolean

Optional image detail enhancement switch.

prompt_content_moderationboolean

Optional moderation switch.

ip_signalboolean

Optional IP warning flag.

syncboolean

Optional sync hint. CometAPI returns final results immediately without setting this field.

Example request

{
  "prompt": "A paper boat floating on calm water at sunrise."
}

Response

Image generation result.

Example response

{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}