Ideogram
  • Welcome to Ideogram
  • Quick Start Guide
  • Frequently Asked Questions
  • Using Ideogram
    • Getting Started
      • Signup and registration
      • Generating Images
      • The Basics, step-by-step
      • Downloading Images
      • Sharing Images
    • Account Settings
      • User Management
      • Managing Your Subscription
    • Prompting Guide
      • In a Nutshell
      • 1- What is Prompting
      • 2- Prompting Fundamentals
        • Text and Typography
      • 3- Prompt Structure
      • 4- Handling Negatives
      • 5- Common Pitfalls & Fixes
        • Importance of Precision
      • 6- Prompt Iteration & Refinement
      • 7- Creative Tools in Ideogram
        • Using Magic Prompt
      • 8- Troubleshooting
      • 9- Vocabulary Help
        • Describing Skin Tones
        • Describing Body Type
        • Memory Colors for Naming Color Nuances
        • Angle of View and Perspective
        • Describing Age and Life Stage
    • Generation Settings
      • Aspect Ratios & Resolutions
      • Available Models
      • Color Palette
      • Magic Prompt
      • Negative Prompt
      • Private Generations
      • Render Speed
      • Seed Number
      • Style
      • Tile
    • Features & Tools
      • Batch Generation
      • Describe
      • Remix
      • Replace/Remove Background
      • Search
      • Upscale
  • Canvas & Editing
    • Canvas
      • Canvas Overview
      • Extend
      • Generate & Remix
      • Magic Fill
      • Text tool
    • Editor
    • Image Upload
  • Community & Social
    • Creator Titles
    • Muting Other Users
  • Plans and Pricing
    • Personal Plans
    • Team Plan
    • Ideogram API (beta)
  • Legal & Support
    • Support
    • Privacy Policy
    • Terms of Service
  • About Ideogram
    • Company
    • Blog Posts
    • Website
    • iOS app
    • External Links
      • Discord
      • Twitter
      • Instagram
      • Ideogram Creators Club
      • Careers
Powered by GitBook
On this page
  • Signup
  • Generating an API key
  • Adjusting the Top-Up Balance and Threshold
  • Useful links
  1. Plans and Pricing

Ideogram API (beta)

PreviousTeam PlanNextSupport

Last updated 3 months ago

Ideogram’s API offers powerful capabilities for developers and businesses looking to integrate Ideogram into their applications. Below are the basics to get started with Ideogram’s API.

Signup

To set up or access the Ideogram API, you first need to log in to your . If you don’t have an account, you can easily create one by following .

Note: Ideogram user subscriptions and API accounts are separate, each with its own payment system. Please note that you must log in to your Ideogram user account (which can be a free account) to set up or access your API account.

Once logged in, click your Profile icon, located at the bottom of the left-side panel, to access the Profile panel and then select API Beta.

After accepting the agreement, you will be directed to the API dashboard. Select the "Manage Payment" button in the lower left corner to add your payment information, which will be linked and used to fund your API credit balance.

Next, choose whether you are using the API for personal or business purposes.

You will then be forwarded to the payment page, where you will need to provide all necessary payment information. You will only be charged when you create your first API key.

Generating an API key

IMPORTANT: • The full API key will only be shown to you once, at the time of its creation. You need to store it in a safe place immediately, as it will not be displayed again afterward.

• Generating the API key may take some time. Please do not refresh or close the window until the process is complete.

You can now click the "Create API key" button to generate your first API key, which will allow you to integrate Ideogram into your applications. You may create multiple API keys, and all keys you generate will be billed under the same plan.

Once created, the keys will appear as partial keys, displaying only the first few characters as a security measure. They will appear as shown in the image below.

You can click "Manage payment", located near the bottom of the API management window, at any time to update your linked payment information or billing details.

Adjusting the Top-Up Balance and Threshold

You can adjust the minimum balance that triggers an automatic top-up. Additionally, you can set the account balance level that you want your automatic top-up to bring you to. By default, the minimum balance threshold is $10 and the top-up balance is $40. To adjust these values, click the Edit button and enter your desired amounts in the respective fields. Then, click Save to confirm your changes.

After that modification, every time the balance dips to $5.00 or below, it will automatically top-up to the predetermined amount of $80.00.

Note: The minimum balance threshold must be above $2.00 and the top up balance must be above $10.00.

Useful links

You will need then need to accept the to proceed.

At this point, you will be ready to create your first API key, which will trigger an initial funding that will be added to your balance. As you use the API, funds will be deducted from your credit balance based on our . Your balance will automatically top-up to a predetermined value when it drops below a certain threshold. In the example image below, the Top-up Balance is $40.00 and the Minimum Balance Threshold is $10.00.

API Docs:

API Agreement and Policy (TOS):

API Status:

API Pricing:

Developer API Agreement and Policy
API pricing
https://developer.ideogram.ai
https://about.ideogram.ai/legal/api-tos
https://status.ideogram.ai/
https://about.ideogram.ai/api-pricing
Ideogram user account
these steps
You need to accept the Developer API Agreement and Policy before continuing with the signup process.
Provide all payment information here. You will only be charged when you create your first API key.
This is how generated API keys appear in the Manage API
Click on the Edit button to change the values.
Click on the Save button to save your changes.