# Ideogram API

Ideogram publishes a public search API over its indexed pages; the guide is at https://ideogram.ai/agents/agent-access.

Source: https://ideogram.ai/api-learn/
Source observed: 2026-11-08T15:45:23.625Z
Last checked: 2026-11-08T15:45:23.625+00:00
Indexed: 2026-11-08T16:09:47.126+00:00

---

# Ideogram API

We provide an API for putting image generation and creative workflows directly into a product. Send a prompt or reference image, receive an image URL, and route the result wherever your product needs it.

Our API supports:

- Image generation
- Prompt-based image editing and image-to-image Remix
- Background removal
- Layerized text and text-layer editing
- Image upscaling
- Custom apps and focused creative workflows
- Custom model training and generation

[Build with API](https://ideogram.ai/platform?intent=api&source=api-learn-hero) · [Read the API docs](https://developer.ideogram.ai/ideogram-api/api-overview)

## Quickstart

Send a prompt to the Ideogram 4.0 generate endpoint and read the image URL from the first item in `data`.

### Python

```python
import requests

response = requests.post(
    "https://api.ideogram.ai/v1/ideogram-v4/generate",
    headers={"Api-Key": "<your-api-key>"},
    json={
        "text_prompt": "A poster for a summer design conference"
    },
)

image = response.json()["data"][0]
print(image["url"])
```

### cURL

```bash
curl -X POST https://api.ideogram.ai/v1/ideogram-v4/generate \\
  -H "Api-Key: <your-api-key>" \\
  -H "Content-Type: application/json" \\
  -d '{
    "text_prompt": "A poster for a summer design conference"
  }'
```

### TypeScript

```typescript
const res = await fetch(
  "https://api.ideogram.ai/v1/ideogram-v4/generate",
  {
    method: "POST",
    headers: {
      "Api-Key": "<your-api-key>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      text_prompt: "A poster for a summer design conference"
    }),
  },
);

const { data } = await res.json();
console.log(data[0].url);
```

## Text to image API

Turn a prompt into production-ready imagery with our family of image models. Generate campaign concepts, product visuals, editorial art and graphic designs from one request, with prompt fidelity and clear text rendering.

- [View models](https://ideogram.ai/tools/)
- [Read the docs](https://developer.ideogram.ai/ideogram-api/api-overview)

## Image to image API

Start with a reference image and guide the output with a prompt. The **Remix** endpoint keeps the structure you need while changing style, subject and detail, so you can iterate without rebuilding the composition from scratch.

- [View models](https://ideogram.ai/tools/)
- [Read the docs](https://developer.ideogram.ai/ideogram-api/api-overview)

## Image upscaling API

Increase resolution while recovering texture and detail. Use the **Upscale API** to prepare generated or existing images for larger placements, sharper crops and high-resolution delivery.

[Read the docs](https://developer.ideogram.ai/ideogram-api/api-overview)

## Custom apps API

Bring focused creative workflows into a product without starting from a blank prompt box. Custom apps turn repeatable tasks into clear inputs and outputs so teams can automate a specific job.

- [View apps](https://ideogram.ai/tools/)
- [Read the docs](https://developer.ideogram.ai/ideogram-api/api-overview)

## Custom model training

Train on a curated set of brand assets, product photos, character illustrations or artwork, then call the resulting model in a generation workflow. This supports visually consistent repeated output without rebuilding the look in every prompt.

- [Learn more](https://ideogram.ai/features/custom-models/)
- [Read the custom-model training docs](https://developer.ideogram.ai/tutorials/custom-model-training)

## Frequently asked questions

### What can I build with the Ideogram API?

You can build image generation, prompt-based editing, background removal, custom model workflows, text-layer editing, creative testing tools and internal design automation.

### Where do I get an API key?

Get an API key through [Build with API](https://ideogram.ai/platform?intent=api&source=api-learn-faq).

### How much does it cost?

See the [API Pricing Page](https://ideogram.ai/api-pricing/).

### Can I use custom models through the API?

Yes. Train a custom model, then generate with it by passing its URI.

### How should I think about scale?

The default limit is **10 in-flight requests** while prototyping. For larger workloads, contact `partnership@ideogram.ai` to size throughput to your needs.

## Privacy

We use cookies to keep the site working, understand usage and support marketing. Optional cookies are on by default; preferences can be changed at any time. Read our [Privacy Policy](https://ideogram.ai/legal/privacy/).

---

[Read this page’s summary](https://ideogram.ai/agents/api/public/v1/page-tldr?url=https%3A%2F%2Fideogram.ai%2Fapi-learn%2F&trace=t_380edc68d53d)

## Ask a follow-up about this page

Need a more specific answer? Ask the exact question you have. It returns a fresh, cited answer from Ideogram’s knowledge base. No account or API key required.

Open this URL with your own question, URL-encoded. Include your question in q. All research inputs are optional; no account or setup.

`GET https://ideogram.ai/agents/agent/faq?q={question}&trace=t_380edc68d53d`

[Tool guide and examples](https://ideogram.ai/agents/agent-access) · [OpenAPI](https://ideogram.ai/agents/api/public/v1/openapi.json) · [Page TLDR form](https://ideogram.ai/agents/agent-tools/page-tldr?url=https%3A%2F%2Fideogram.ai%2Fapi-learn%2F). Opening a form does not execute a tool.