Ideogram V2 Turbo API

Turbo
Remix
Edit

Endpoint: POST https://fal.run/fal-ai/ideogram/v2/turbo Endpoint ID: fal-ai/ideogram/v2/turbo

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

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
}

Endpoint: POST https://fal.run/fal-ai/ideogram/v2/turbo/remix Endpoint ID: fal-ai/ideogram/v2/turbo/remix

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/turbo/remix",
    arguments={
        "prompt": "An ice field in north atlantic",
        "image_url": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Input Schema

prompt

string

required

The prompt to remix the image with

image_url

string

required

The image URL to remix

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

strength

float

default:"0.8"

Strength of the input image in the remix Default value: 0.8Range: 0.01 to 1

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": "An ice field in north atlantic",
  "image_url": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png",
  "aspect_ratio": "1:1",
  "strength": 0.8,
  "expand_prompt": true,
  "style": "auto",
  "sync_mode": false
}

Output Example

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

Endpoint: POST https://fal.run/fal-ai/ideogram/v2/turbo/edit Endpoint ID: fal-ai/ideogram/v2/turbo/edit

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/turbo/edit",
    arguments={
        "prompt": "A knight in shining armour holding a greatshield with \"FAL\" on it",
        "image_url": "https://storage.googleapis.com/falserverless/flux-lora/example-images/knight.jpeg",
        "mask_url": "https://storage.googleapis.com/falserverless/flux-lora/example-images/mask_knight.jpeg"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Input Schema

prompt

string

required

The prompt to fill the masked part of the image.

image_url

string

required

The image URL to generate an image from. Needs to match the dimensions of the mask.

mask_url

string

required

The mask URL to inpaint the image. Needs to match the dimensions of the input image.

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

expand_prompt

boolean

default:"true"

Whether to expand the prompt with MagicPrompt functionality. 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<File>

required

seed

integer

required

Seed used for the random number generator

Input Example

{
  "prompt": "A knight in shining armour holding a greatshield with \"FAL\" on it",
  "image_url": "https://storage.googleapis.com/falserverless/flux-lora/example-images/knight.jpeg",
  "mask_url": "https://storage.googleapis.com/falserverless/flux-lora/example-images/mask_knight.jpeg",
  "style": "auto",
  "expand_prompt": true,
  "sync_mode": false
}

Output Example

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

Ideogram V2 Turbo Remix — Image Generation
Ideogram V2 Turbo Edit — Image Generation
Ideogram V2 Turbo — Image Generation

Limitations

style restricted to: auto, general, realistic, design, render_3D, anime
strength range: 0.01 to 1

Video Generation

Image Generation

Audio

Vision

3D

Ideogram V2 Turbo API

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Limitations

Video Generation

Image Generation

Audio

Vision

3D

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

​Related

​Limitations

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Related

Limitations