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

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/v2",
    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)

​
Examples

A playful cat is sitting on the right side of a vibrant beach ball, situated on a sunny, sandy beach. The beach is dotted with sunbathers and colorful umbrellas. Waves gently lap at the shore, and a pristine blue sky is adorned with a few fluffy white clouds. Seagulls soar overhead, adding to the li…
Generated image: A playful cat is sitting on the right side of a vibrant beach ball, situated on
A warm, hyper-detailed, low-saturation scene in the style of David Lynch, set against a soft-focus suburban American backdrop with muted colors and soothing tones, evoking a sense of nostalgia. Two characters, a young, ethnically ambiguous woman with sun-kissed, golden-brown skin and a bright, enigm…
Generated image: A warm, hyper-detailed, low-saturation scene in the style of David Lynch, set ag
A marble-skinned figure with neoclassical features, matte skin, and wrinkles, majestically strides forward on a serene tropical beach with a palm tree and green foliage, amidst a blurred bustling galactic trade hub background.
Generated image: A marble-skinned figure with neoclassical features, matte skin, and wrinkles, ma

​
Capabilities

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

​
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.
​
negative_prompt
string
default:""
A negative prompt to avoid in the generated image Default value: ""

​
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,
  "negative_prompt": ""
}

​
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