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

Official

ideogram-ai / ideogram-v2

An excellent image model with state of the art inpainting, prompt comprehension and text rendering

Warm

Public
711.2K runs
$0.08 per image
Weights
Paper
License

Run with an API

This model uses a mask. Visit the new playground to try this model with our mask editing tool.

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

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

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

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 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

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

const output = await replicate.run("ideogram-ai/ideogram-v2", { input });
console.log(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 using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "ideogram-ai/ideogram-v2",
    input={
        "prompt": "An illustration of a black running shoe with the text \"Run AI with an API\" written on the shoe. The shoe is placed on a blue background. The text is white and bold. The overall image has a modern and techy vibe.",
        "resolution": "None",
        "style_type": "None",
        "aspect_ratio": "16:9",
        "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 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 black running shoe with the text \\"Run AI with an API\\" written on the shoe. The shoe is placed on a blue background. The text is white and bold. The overall image has a modern and techy vibe.",
      "resolution": "None",
      "style_type": "None",
      "aspect_ratio": "16:9",
      "magic_prompt_option": "Auto"
    }
  }' \
  https://api.replicate.com/v1/models/ideogram-ai/ideogram-v2/predictions

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

Output

Generated in

19.6 seconds

Tweak itReport

Examples

View more examples

Pricing

This model is priced by how many images are generated.

Type	Per unit	Per $1
Output	$0.08 / image or 12 images / $1

For example, generating 100 images should cost around $8.00.

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

Readme

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