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

Official

ideogram-ai / ideogram-v2a

Like Ideogram v2, but faster and cheaper

Warm

Public
689.3K runs
$0.04 per image
Commercial use
Paper
License

Iterate in playground

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

Vector art of a friendly robot, in a speech bubble it says "Hello! I'm Ideogram V2A" in a friendly font, in a second speech bubble it says "I'm faster!", the robot is in a 3D gardenVector art of a friendly robot, in a speech bubble it says "Hello! I'm Ideogram V2A" in a friendly font, in a second speech bubble it says "I'm faster!", the robot is in a 3D garden

Text prompt for image generation

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"

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-v2a

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";
import fs from "node:fs";

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

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

const input = {
  prompt: "Vector art of a friendly robot, in a speech bubble it says \"Hello! I'm Ideogram V2A\" in a friendly font, in a second speech bubble it says \"I'm faster!\", the robot is in a 3D garden",
  resolution: "None",
  style_type: "None",
  aspect_ratio: "3:2",
  magic_prompt_option: "Auto"
};

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

output = replicate.run(
    "ideogram-ai/ideogram-v2a",
    input={
        "prompt": "Vector art of a friendly robot, in a speech bubble it says \"Hello! I'm Ideogram V2A\" in a friendly font, in a second speech bubble it says \"I'm faster!\", the robot is in a 3D garden",
        "resolution": "None",
        "style_type": "None",
        "aspect_ratio": "3:2",
        "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-v2a 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": "Vector art of a friendly robot, in a speech bubble it says \\"Hello! I\'m Ideogram V2A\\" in a friendly font, in a second speech bubble it says \\"I\'m faster!\\", the robot is in a 3D garden",
      "resolution": "None",
      "style_type": "None",
      "aspect_ratio": "3:2",
      "magic_prompt_option": "Auto"
    }
  }' \
  https://api.replicate.com/v1/models/ideogram-ai/ideogram-v2a/predictions

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