---
title: "Create image from text - Ideogram 4"
method: POST
path: "/v1/ai/text-to-image/ideogram-4"
tags: ["text-to-image"]
---

# Create image from text - Ideogram 4

`POST /v1/ai/text-to-image/ideogram-4`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-image/ideogram-4`
- Auth: API key in header `x-magnific-api-key`

Generate images from text with Ideogram 4.

**Key Features:**
- Accurate text rendering for posters, logos and typography
- 15 aspect ratios, from `3:1` to `1:3`, always at about 4 megapixels
- Optional negative prompt, Magic Prompt control and seed

**Best for:**
- Posters, flyers and social graphics with legible text
- Logos and typographic designs

**Credits:** the price is set by `rendering_speed` (`TURBO`, `DEFAULT` or
`QUALITY`). The other parameters do not affect it.

## Request body

- TtiIdeogram4Request
  - `prompt` string, required: Text description of the image to generate. Ideogram 4 is especially good at rendering text: put the words to draw in quotes.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.
  - `negative_prompt` string: What to leave out of the image. Descriptions in `prompt` take precedence over this field.
  - `aspect_ratio` '1:1' | '16:9' | '9:16' | '16:10' | '10:16' | '4:3' | '3:4' | '3:2' | '2:3' | '5:4' | '4:5' | '2:1' | '1:2' | '3:1' | '1:3': Aspect ratio for the generated image. The output is always about 4 megapixels: 2048x2048 at `1:1`, and the same area at the other ratios. **Available ratios:** - `1:1`: Square (default) - `16:9`, `9:16`: Widescreen/Social stories - `16:10`, `10:16`: Widescreen/Tall - `4:3`, `3:4`: Standard - `3:2`, `2:3`: Classic photo - `5:4`, `4:5`: Photo print - `2:1`, `1:2`, `3:1`, `1:3`: Banners and vertical panels
  - `rendering_speed` 'TURBO' | 'DEFAULT' | 'QUALITY': Quality tier. It sets the price of the generation. **Available tiers:** - `TURBO`: Fastest and cheapest - `DEFAULT`: Balanced quality and speed (default) - `QUALITY`: Highest quality, slowest
  - `magic_prompt` 'AUTO' | 'ON' | 'OFF': Whether Ideogram's Magic Prompt rewrites the prompt into a more detailed one before generating. `AUTO` lets the model decide; use `OFF` to render the prompt verbatim. It does not affect the price.
  - `seed` integer: Seed for reproducible results. When omitted, a random seed is used.

## Response `200`

OK - The request has succeeded and the Ideogram 4 process has started.

- GetStyleTransferTaskStatus200Response
  - `data` TaskDetail, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)