Skip to main content
Endpoint: POST https://fal.run/fal-ai/ideogram/v2a Endpoint ID: fal-ai/ideogram/v2a

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/ideogram/v2a",
    arguments={
        "prompt": "A comic style illustration of a skeleton sitting on a toilet in a bathroom. The bathroom has a Halloween decoration with a pumpkin jack-o-lantern and bats flying around. There is a text above the skeleton that says \"Just Waiting for Halloween with Ideogram 2.0 at fal.ai\""
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Capabilities

  • Text prompt input
  • Aspect ratio control
  • Reproducible generation (seed)
  • Synchronous mode

​
API Reference

​
Input Schema

​
prompt
string
required
​
aspect_ratio
AspectRatioEnum
default:"1:1"
The aspect ratio of the generated image Default value: "1:1"Possible values: 10:16, 16:10, 9:16, 16:9, 4:3, 3:4, 1:1, 1:3, 3:1, 3:2, 2:3
​
expand_prompt
boolean
default:"true"
Whether to expand the prompt with MagicPrompt functionality. Default value: true
​
seed
integer
Seed for the random number generator
​
style
StyleEnum
default:"auto"
The style of the generated image Default value: "auto"Possible values: auto, general, realistic, design, render_3D, anime
​
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<File>
required
​
seed
integer
required
Seed used for the random number generator

​
Input Example

{
  "prompt": "A comic style illustration of a skeleton sitting on a toilet in a bathroom. The bathroom has a Halloween decoration with a pumpkin jack-o-lantern and bats flying around. There is a text above the skeleton that says \"Just Waiting for Halloween with Ideogram 2.0 at fal.ai\"",
  "aspect_ratio": "1:1",
  "expand_prompt": true,
  "style": "auto",
  "sync_mode": false
}

​
Output Example

{
  "images": [
    {
      "url": "https://fal.media/files/monkey/cNaoxPl0YAWYb-QVBvO9F_image.png"
    }
  ],
  "seed": 123456
}

​
Limitations

  • style restricted to: auto, general, realistic, design, render_3D, anime