Ideogram API

API Setup

Ideogram’s API offers powerful capabilities for developers and businesses looking to integrate Ideogram into their applications. Everything below happens in the API dashboard.

IMPORTANT: Image links created by the Ideogram API expire. If you want to keep the image, you must download it and store it.

Get access

  1. Log in to your Ideogram account at ideogram.ai. If you don’t have one, sign up first — a free account is enough.
  2. Open the API dashboard. You can also reach it from the API Dashboard entry in the app’s navigation, or via API keys in the account menu.
  3. The first time you open the dashboard, accept the Developer API Agreement and Policy to continue.

Ideogram subscriptions and API accounts are billed separately. An Ideogram subscription does not include API credits, and API spending does not count toward a subscription.

Add a payment method

Open the Billing tab and add a payment method (processed by Stripe). You can create API keys before doing this, but they stay inactive — requests only succeed once your account has a payment method and a positive credit balance.

You can update your payment details or add tax information at any time from the Billing tab via the Stripe customer portal.

Add credits

API usage is prepaid: requests draw down a credit balance according to the API pricing. There are two ways to fund it, both in the Billing tab:

  • Add credits — a one-time purchase of $20, $50, $100, or a custom amount (minimum $1; your balance cannot exceed $300).
  • Auto recharge — when your balance drops below the Minimum balance threshold, it is automatically topped back up to the Top-up balance target. The defaults are a $10 threshold and a $20 top-up target, and auto-recharge starts out disabled.

When customizing auto-recharge: the threshold must be between $5 and $900, the top-up target between $10 and $1,000, and the target must exceed the threshold by at least $10. Custom recharge settings unlock after your account has made its first API calls.

Create an API key

Go to the API Keys tab and select Create key. You can give each key an optional name to keep track of where it is used.

IMPORTANT: The full API key will only be shown to you once, at the time of its creation. Copy and store it securely — afterwards only a partial key is displayed.

You can create multiple keys; they all draw from the same credit balance. Keys can be revoked at any time from the same tab.

Pass the key in the Api-Key header on every request.

Teams

To share API access with collaborators, create an API team from the workspace switcher in the dashboard. A team shares API keys, credits, and billing across its members, with Owner, Admin, and Member roles. Invite members by Ideogram username or email from the Members tab.

Try it in the Playground

The Playground tab lets you run API endpoints directly from the browser: paste an API key, fill in the request fields, and inspect the response alongside a ready-to-copy cURL command. Your key is kept in memory only and never stored.