# Ideogram API The Ideogram API offers powerful image generation and editing capabilities for developers and businesses looking to integrate Ideogram into their applications. Read our API Docs to learn more: Review API pricing here: ## Signup To set up or access the Ideogram API, you first need to log in to your [Ideogram user account](https://ideogram.ai/). If you don’t have an account, you can easily create one by following [these steps](/using-ideogram/getting-started/signup-and-registration.md). {% hint style="warning" %} **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. {% endhint %} 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**.
You will need then need to accept the [Developer API Agreement and Policy](https://about.ideogram.ai/api-tos) to proceed.

You need to accept the Developer API Agreement and Policy before continuing with the signup process.

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.

Provide all payment information here. You will only be charged when you create your first API key.

## Generating an API Key {% hint style="danger" %} **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. {% endhint %} 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 [API pricing](https://about.ideogram.ai/api-pricing). 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 $20.00 and the Minimum Balance Threshold is $10.00.
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.

This is how generated API keys appear in the Manage API

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 $20. To adjust these values, click the Edit button and enter your desired amounts in the respective fields. Then, click Save to confirm your changes.

Click on the Edit button to change the values.

Click on the Save button to save 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. {% hint style="info" %} Note: The minimum balance threshold must be above $2.00 and the top up balance must be above $10.00. {% endhint %} ## Useful Links * API Docs: * API Agreement and Policy (TOS): * API Status: * API Pricing: --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ideogram.ai/plans-and-pricing/ideogram-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.