Skip to main content
Endpoint: POST https://fal.run/fal-ai/bytedance/seedream/v3/text-to-image Endpoint ID: fal-ai/bytedance/seedream/v3/text-to-image

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/bytedance/seedream/v3/text-to-image",
    arguments={
        "prompt": "Fisheye lens, the head of a cat, the image shows the effect that the facial features of the cat are distorted due to the shooting method."
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Input Schema

​
prompt
string
required
The text prompt used to generate the image
​
image_size
ImageSize | Enum
Use for finer control over the output image size. Will be used over aspect_ratio, if both are provided. Width and height must be between 512 and 2048.Possible values: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
​
guidance_scale
float
default:"2.5"
Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation. Default value: 2.5Range: 1 to 10
​
num_images
integer
default:"1"
Number of images to generate Default value: 1Range: 1 to 4
​
seed
integer
Random seed to control the stochasticity of image generation.
​
enable_safety_checker
boolean
default:"true"
If set to true, the safety checker will be enabled. Default value: true
​
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
Generated images
​
seed
integer
required
Seed used for generation

​
Input Example

{
  "prompt": "Fisheye lens, the head of a cat, the image shows the effect that the facial features of the cat are distorted due to the shooting method.",
  "guidance_scale": 2.5,
  "num_images": 1,
  "enable_safety_checker": true,
  "sync_mode": false
}

​
Output Example

{
  "images": [
    {
      "url": "https://v3.fal.media/files/rabbit/EJqemc4hQlHKAtkkfTJqB_a2aaccab7ff84740b6323da580146087.png"
    }
  ],
  "seed": 42
}

​
Limitations

  • image_size restricted to: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
  • guidance_scale range: 1 to 10
  • num_images range: 1 to 4
  • Content moderation via safety checker