Skip to main content
Endpoint: POST https://fal.run/fal-ai/bria/text-to-image/hd Endpoint ID: fal-ai/bria/text-to-image/hd

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/bria/text-to-image/hd",
    arguments={
        "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical valley. The figure is clad in flowing robes that ripple in the gentle breeze, silhouetted against the golden and lavender hues of the sky. Below, a cascading waterfall pours into a sparkling river winding through a forest of bioluminescent trees. The scene blends the awe of nature with a touch of otherworldly wonder, inviting reflection and imagination."
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Input Schema

​
prompt
string
required
The prompt you would like to use to generate images.
​
negative_prompt
string
default:""
The negative prompt you would like to use to generate images. Default value: ""
​
num_images
integer
default:"4"
How many images you would like to generate. When using any Guidance Method, Value is set to 1. Default value: 4Range: 1 to 4
​
aspect_ratio
AspectRatioEnum
default:"1:1"
The aspect ratio of the image. When a guidance method is being used, the aspect ratio is defined by the guidance image and this parameter is ignored. Default value: "1:1"Possible values: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9
​
seed
integer
The same seed and the same prompt given to the same version of the model will output the same image every time.Range: 0 to 2147483647
​
num_inference_steps
integer
default:"30"
The number of iterations the model goes through to refine the generated image. This parameter is optional. Default value: 30Range: 20 to 50
​
guidance_scale
float
default:"5"
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Default value: 5Range: 0 to 20
​
prompt_enhancement
boolean
default:"false"
When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images.
​
medium
MediumEnum
Which medium should be included in your generated images. This parameter is optional.Possible values: photography, art
​
guidance
list<GuidanceInput>
default:""
Guidance images to use for the generation. Up to 4 guidance methods can be combined during a single inference.
​
sync_mode
boolean
default:"false"
If True, the media will be returned as a data URI and the output data won’t be available in the request history.

​
Output Schema

​
images
list<Image>
required
The generated images
​
seed
integer
required
Seed value used for generation.

​
Input Example

{
  "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical valley. The figure is clad in flowing robes that ripple in the gentle breeze, silhouetted against the golden and lavender hues of the sky. Below, a cascading waterfall pours into a sparkling river winding through a forest of bioluminescent trees. The scene blends the awe of nature with a touch of otherworldly wonder, inviting reflection and imagination.",
  "negative_prompt": "",
  "num_images": 4,
  "aspect_ratio": "1:1",
  "num_inference_steps": 30,
  "guidance_scale": 5,
  "prompt_enhancement": false,
  "guidance": [],
  "sync_mode": false
}

​
Output Example

{
  "images": [
    {
      "content_type": "image/png",
      "file_name": "257cf8e7bd3a47c2959396343d5b38cf.png",
      "file_size": 3731290,
      "height": 1536,
      "url": "https://v3.fal.media/files/tiger/48e63e0K6C9XQYBuomoU-_257cf8e7bd3a47c2959396343d5b38cf.png",
      "width": 1536
    }
  ]
}

​
Limitations

  • num_images range: 1 to 4
  • seed range: 0 to 2147483647
  • num_inference_steps range: 20 to 50
  • guidance_scale range: 0 to 20
  • medium restricted to: photography, art
  • num_inference_steps range: 4 to 10