# Generate Image - HD





This Image Generation pipeline is designed for builders working on projects that demand maximum image detail and clarity. It leverages Bria’s proprietary text-to-image foundation models, enhanced to deliver high-resolution outputs while preserving control and flexibility. The pipeline supports native generation at 1920×1080 resolution (or 1536×1536 for square aspect ratios) and accommodates a wide range of aspect ratios, making it ideal for use cases where visual precision and output quality are critical.



: A photo of detailed short female blond hair viewed from behind, with rich texture and clearly visible individual strands that give depth and realism, and featuring subtle waves reflect light



 

: A portrait of a Beautiful and playful ethereal singer, art deco, fantasy, intricate art deco golden designs, elegant, highly detailed, sharp focus, blurry background, teal and orange shades



 
This API endpoint supports content moderation via an optional parameter that filters out unsafe generated images.       

Endpoint: POST /text-to-image/hd/{model_version}

## Path parameters:

  - `model_version` (string, required)
    The model version you would like to use in the request.
    Enum: "2.2"

## Header parameters:

  - `api_token` (string, required)

## Request fields (application/json):

  - `prompt` (string)
    The prompt you would like to use to generate images. Bria currently supports prompts in English only, excluding special characters.

  - `num_results` (integer)
    How many images you would like to generate.

  - `aspect_ratio` (string)
    The aspect ratio of the image.
    Enum: "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9"

  - `sync` (boolean)
    Determines the response mode. When true, responses are synchronous, and applicable to single-image requests. With false, responses are asynchronous, immediately providing URLs for images that are generated in the background. Use polling for the URLs to retrieve images once ready.

  - `seed` (integer)
    You can choose whether you want your generated result to be random or predictable. You can recreate the same result in the future by using the seed value of a result from the response with the prompt, model type and model version. You can exclude this parameter if you are not interested in recreating your results. This parameter is optional.

  - `negative_prompt` (string)
    Specify here elements that you didn't ask in the prompt, but are being generated, and you would like to exclude. This parameter is optional. Bria currently supports prompts in English only.

  - `steps_num` (integer)
    The number of iterations the model goes through to refine the generated image. This parameter is optional.

  - `text_guidance_scale` (number)
    Determines how closely the generated image should adhere to the input text description. This parameter is optional.

  - `medium` (string)
    Which medium should be included in your generated images. This parameter is optional.
    Enum: "photography", "art"

  - `prompt_enhancement` (boolean)
    When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images. Note that turning this flag on may result in a few additional seconds to the inference time.

  - `enhance_image` (boolean)
    When set to true, generates images with richer details, sharper textures, and enhanced clarity.

Slightly increases generation time per image.

  - `content_moderation` (boolean)
    When enabled, applies content moderation to generated outputs.

For synchronous requests (sync=true):
- If all generated images fail moderation, returns a 422 error
- If some images pass and others fail, returns a 200 response with successful generations and "blocked" objects for failed ones

For asynchronous requests (sync=false):
- Failed images are replaced with zero-byte files at their placeholder URLs
- Successful images are stored at their original placeholder URLs

  - `ip_signal` (boolean)
    Flags prompts with potential IP content. If detected, a warning will be included in the response.

## Response 209 fields (application/json):

  - `result` (array)
    There are multiple objects in this array (based on the amount specified in num_results) and each object represents a single image or a blocked result.