> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ideogram 4.5 API

> Generate and edit images with accurate text using Ideogram 4.5. Up to 5 input images, 13 aspect ratios at about 4 megapixels plus auto, and four quality tiers.

<Card title="Ideogram 4.5" icon="font">
  Generate images with accurate text, or edit an existing image with a text instruction guided by up to four references.
</Card>

Ideogram 4.5 generates and edits images, with Ideogram's strength in rendering text. One endpoint covers both: send a `prompt` alone to generate an image, or add `images` to edit the first one, using the rest as references. It renders at about 4 megapixels in 13 aspect ratios, or follows the input image with `auto`.

### Key capabilities

* **Generation and editing in one endpoint**: Text-to-image, or edit an image with up to **5** `images`
* **Refer to images by position**: `image 1` is the image being edited and `image 2` onwards are the references, so the prompt can say *"put the logo from image 2 on the bottle in image 1"*
* **Text rendering**: Headlines, logos and labels written exactly as quoted in the prompt
* **Aspect ratios**: 13 ratios from `3:1` to `1:3` at about 4 megapixels, plus `auto` (default) to follow the input image
* **Four quality tiers**: `quality` `very_low`, `low`, `medium` or `high`. It is the only parameter that changes the price
* **Magic Prompt** and **seed** control
* **Prompt range**: 1 to 10,000 characters
* **Async processing**: Webhook notification or polling for task completion

### Use cases

* **Text edits**: Change the copy of a sign, label or poster while keeping the rest of the image
* **Brand assets**: Apply a logo or product from a reference to a new design
* **Restyling**: Turn a photo into an illustration, watercolor or poster
* **Posters and social graphics**: Designs with legible text, from scratch

### API operations

Create an image with the POST endpoint, then track it with the list and status endpoints. Generation returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-image/ideogram-4-5" icon="wand-magic-sparkles" href="/api-reference/text-to-image/ideogram-4-5/generate">
      Create a new image generation or editing task
    </Card>

    <Card title="GET /v1/ai/text-to-image/ideogram-4-5" icon="list" href="/api-reference/text-to-image/ideogram-4-5/ideogram-4-5-tasks">
      List all Ideogram 4.5 tasks
    </Card>

    <Card title="GET /v1/ai/text-to-image/ideogram-4-5/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/ideogram-4-5/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `prompt` | `string` | Yes | - | Text description of the image, or of the edit to apply (1-10,000 characters) |
| `images` | `array` | No | - | Up to 5 images, each a public HTTPS URL or base64 string. The first one is edited; the rest are references |
| `quality` | `string` | No | `medium` | `very_low`, `low`, `medium`, `high`. Sets the price. `very_low` requires `images` |
| `aspect_ratio` | `string` | No | `auto` | `auto`, `1:1`, `4:5`, `5:4`, `3:4`, `4:3`, `2:3`, `3:2`, `9:16`, `16:9`, `1:2`, `2:1`, `1:3`, `3:1` |
| `magic_prompt` | `string` | No | `auto` | `auto`, `on`, `off` |
| `seed` | `integer` | No | random | 0 to 2147483647 |
| `webhook_url` | `string` | No | - | URL for async status notifications |

### Output sizes

The output is up to about 4 megapixels, shaped to the requested ratio. Measured examples:

| `aspect_ratio` | Input | Output |
| - | - | - |
| `auto` | none | 2048x2048 |
| `auto` | a 16:9 image | 2720x1536 (follows the input) |
| `1:1` | any | 2048x2048 |
| `16:9` | any | 2560x1440 |
| `9:16` | any | 1440x2560 |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Ideogram 4.5 and how does it work?">
    Ideogram 4.5 is Ideogram's image generation and editing model. You send a `prompt` (1-10,000 characters), optionally with up to 5 `images`, and receive a task ID immediately. Poll the task endpoint or configure a `webhook_url` to receive the generated image URL when processing completes. Each request generates one image.
  </Accordion>

  <Accordion title="How do I edit an image?">
    Send it as the first entry of `images` and describe the change in the prompt, for example *"change the neon sign in image 1 so it reads CLOSED in blue neon; keep everything else unchanged"*. Add up to four more images as references and name them by position (`image 2`, `image 3`…). Set `magic_prompt` to `off` for verbatim edit instructions.
  </Accordion>

  <Accordion title="How do I keep the proportions of my input image?">
    Leave `aspect_ratio` at its default, `auto`. With images, the output follows the first image (a 16:9 input returns a 16:9 output). Without images, `auto` lets the model pick the canvas that best fits the prompt. Any other value reshapes the output to that ratio.
  </Accordion>

  <Accordion title="Why is very_low rejected for my request?">
    `very_low` is only available when you send `images` (editing). A text-only request with `quality: very_low` is rejected with a 400 error and is not charged. Use `low` or higher for text-to-image.
  </Accordion>

  <Accordion title="What image formats are supported?">
    PNG, JPEG and WebP, as a public HTTPS URL or a base64-encoded string, with an aspect ratio between 1:6 and 6:1. Plain `http://` URLs are rejected.
  </Accordion>

  <Accordion title="How much does Ideogram 4.5 cost?">
    The price depends only on `quality`: `very_low`, `low`, `medium` or `high`. Input images, aspect ratio and Magic Prompt do not change it. See the [Pricing page](/pricing) for current rates.
  </Accordion>

  <Accordion title="What are the rate limits for Ideogram 4.5?">
    Rate limits depend on your subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How is Ideogram 4.5 different from Ideogram 4?">
    Ideogram 4.5 accepts input images, so it can edit and use references, and prices by `quality` (four tiers). [Ideogram 4](/api-reference/text-to-image/ideogram-4/overview) is text-to-image only, prices by `rendering_speed` (three tiers) and also accepts a `negative_prompt`.
  </Accordion>
</AccordionGroup>

## Best practices

* **Be explicit about what stays**: In edits, say what to change and add *"keep everything else unchanged"*
* **Name images by position**: `image 1` is the one being edited; refer to references as `image 2`, `image 3`…
* **Keep `auto` for edits**: It preserves the proportions of the input image
* **Iterate cheaply**: Explore edits with `very_low` or `low` and render the final asset with `high`
* **Production integration**: Use `webhook_url` instead of polling for scalable applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Ideogram 4](/api-reference/text-to-image/ideogram-4/overview)**: Text-to-image with negative prompts
* **[Ideogram Image Edit](/api-reference/ideogram-image-edit/overview)**: Mask-based inpainting with Ideogram
* **[Nano Banana Pro Flash](/api-reference/text-to-image/nano-banana-pro-flash/overview)**: Google's image generation and editing model


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.