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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/ideogram/v2/turbo", {
  input: {
      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\""
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/ideogram/v2/turbo \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "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\""
}'

Input Schema

string

required

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

boolean

default:"true"

Whether to expand the prompt with MagicPrompt functionality. Default value: true

integer

Seed for the random number generator

StyleEnum

default:"auto"

The style of the generated image Default value: "auto"Possible values: auto, general, realistic, design, render_3D, anime

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.

string

default:""

A negative prompt to avoid in the generated image Default value: ""

Output Schema

list<File>

required

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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/ideogram/v2/turbo/remix", {
  input: {
      prompt: "An ice field in north atlantic",
      image_url: "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png"
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/ideogram/v2/turbo/remix \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "An ice field in north atlantic",
  "image_url": "https://fal.media/files/lion/FHOx4y4a0ef7Sgmo-sOUR_image.png"
}'

Input Schema

string

required

The prompt to remix the image with

string

required

The image URL to remix

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

float

default:"0.8"

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

boolean

default:"true"

Whether to expand the prompt with MagicPrompt functionality. Default value: true

integer

Seed for the random number generator

StyleEnum

default:"auto"

The style of the generated image Default value: "auto"Possible values: auto, general, realistic, design, render_3D, anime

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

list<File>

required

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)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/ideogram/v2/turbo/edit", {
  input: {
      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"
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/fal-ai/ideogram/v2/turbo/edit \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "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"
}'

Input Schema

string

required

The prompt to fill the masked part of the image.

string

required

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

string

required

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

integer

Seed for the random number generator

StyleEnum

default:"auto"

The style of the generated image Default value: "auto"Possible values: auto, general, realistic, design, render_3D, anime

boolean

default:"true"

Whether to expand the prompt with MagicPrompt functionality. Default value: true

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

list<File>

required

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

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