ideogram-ai/ideogram-v2-turbo – Run with an API on Replicate

Official

ideogram-ai / ideogram-v2-turbo

A fast image model with state of the art inpainting, prompt comprehension and text rendering.

Warm

Public
1.8M runs
$0.05 per image
Weights
Paper
License

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

An illustration of a gold running shoe with the text "Run AI with an API" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.An illustration of a gold running shoe with the text "Run AI with an API" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.

Text prompt for image generation

negative_prompt

string

Shift + Return to add a new line

Things you do not want to see in the generated image.

aspect_ratio

string

Aspect ratio. Ignored if a resolution or inpainting image is given.

Default: "1:1"

resolution

string

Resolution. Overrides aspect ratio. Ignored if an inpainting image is given.

Default: "None"

magic_prompt_option

string

Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages.

Default: "Auto"

image

file

An image file to use for inpainting. You must also use a mask.

mask

file

A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size.

style_type

string

The styles help define the specific aesthetic of the image you want to generate.

Default: "None"

seed

integer

(maximum: 2147483647)

Random seed. Set for reproducible generation

Run this model in Node.js with one line of code:

npx create-replicate --model=ideogram-ai/ideogram-v2-turbo

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run ideogram-ai/ideogram-v2-turbo using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  prompt: "An illustration of a gold running shoe with the text \"Run AI with an API\" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.",
  resolution: "None",
  style_type: "None",
  aspect_ratio: "1:1",
  magic_prompt_option: "Auto"
};

const output = await replicate.run("ideogram-ai/ideogram-v2-turbo", { input });

// To access the file URL:
console.log(output.url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run ideogram-ai/ideogram-v2-turbo using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "ideogram-ai/ideogram-v2-turbo",
    input={
        "prompt": "An illustration of a gold running shoe with the text \"Run AI with an API\" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.",
        "resolution": "None",
        "style_type": "None",
        "aspect_ratio": "1:1",
        "magic_prompt_option": "Auto"
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run ideogram-ai/ideogram-v2-turbo using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "input": {
      "prompt": "An illustration of a gold running shoe with the text \\"Run AI with an API\\" written on the shoe. The shoe is placed on a pink background. The text is white and bold. The overall image has a modern and techy vibe, with elements of speed.",
      "resolution": "None",
      "style_type": "None",
      "aspect_ratio": "1:1",
      "magic_prompt_option": "Auto"
    }
  }' \
  https://api.replicate.com/v1/models/ideogram-ai/ideogram-v2-turbo/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

Generated in

12.4 seconds

Tweak it Report

Examples

View more examples

Pricing

This model is priced by how many images are generated.

Check out our docs for more information about how per-image pricing works on Replicate.

Readme

Ideogram v2 Turbo

Turbo generates images quickly and is best used for ideation when you want a quick look at the composition. Sometimes useful for achieving a sketchy look (~7 to ~12 sec)

More about Ideogram

https://docs.ideogram.ai/

Ideogram (pronounced “eye-dee-oh-gram”) is a free-to-use AI tool that turns your ideas into stunning images, in a matter of seconds. Ideogram excels at creating captivating designs, realistic images, innovative logos and posters. With unique capabilities like text rendering in images, we aim to inspire creativity and help every user bring their imagination to life.

Features

https://docs.ideogram.ai/using-ideogram/ideogram-features