# Ideogram 4.5

`ideogram/ideogram-4-5` · Ideogram · image

Create an image from text or edit the first picture you supply. Additional images can guide appearance, and a mask can limit changes to one area.

[Model page](https://sociaro.com/models/ideogram/ideogram-4-5) · [JSON](https://sociaro.com/models/ideogram/ideogram-4-5.json) · [Model pricing](https://sociaro.com/pricing?model=ideogram%2Fideogram-4-5) · [Documentation](https://docs.sociaro.com/models/ideogram-ideogram-4-5/) · [Playground](https://my.sociaro.com/playground/?model=ideogram/ideogram-4-5)

## Use cases

- Build a packaging concept from a product photo and style reference
- Generate campaign artwork with a transparent background

## Technical details

- API model ID — ideogram/ideogram-4-5
- Provider — Ideogram
- Modality — Image
- Input — Text prompt · Images · Edit mask
- Output — Image
- Endpoint — POST /v2/jobs
- Workflow — Text to image

## Request parameters

- `prompt` (string, required) — The prompt to generate images from, or the edit instruction when `images` are sent: natural language or a structured Ideogram 4.0 JSON prompt, 1 to 10000 characters.
  - 1–10000 characters
- `magic_prompt` (string) — Auto and on expand a written prompt. Off preserves your wording while formatting the prompt for generation.
  - Allowed values — `auto`, `on`, `off`
  - A structured prompt bypasses expansion unless you select on.
  - When editing with images, every mode formats the instruction as an edit prompt.
- `size` (string) — Choose auto, a supported pixel size, or source to match the first image when editing. Use size and mask in separate requests.
  - For generation, auto uses the prompt to choose a supported 1K or 2K size.
  - For editing, auto uses a 2K size. Source keeps the first image’s proportions and scales large images to fit.
  - Custom edit dimensions must be multiples of 32, at least 256 on each side, with at most 4,194,304 pixels and a 6:1 ratio in either direction.
- `background` (string) — The output background: `transparent` returns images with an alpha channel, `opaque` a solid one, and `auto` lets the generator decide.
  - Allowed values — `auto`, `transparent`, `opaque`
- `quality` (string) — The rendering quality, from `very_low` (the fastest and cheapest, needs `images`) up to `high`; higher quality takes longer and is priced higher, and it defaults to `medium` with `images` and to `high` without.
  - Allowed values — `very_low`, `low`, `medium`, `high`
- `seed` (integer) — Random seed, a whole number from 0 to 2147483647; set it for reproducible generation.
  - 0–2147483647
- `images` (array) — Source images to edit: the first one is edited and any others are extra references; at most 3 when `mask` is sent. 1 to 5 public https URLs that answer without a redirect; each JPEG, PNG or WEBP, up to 25 MB.
  - 1–5 items
- `mask` (string) — Apply edits to the black parts of a mask and preserve the white parts. Match the mask dimensions to the first input image.
  - Include both black and white. Supply a direct public HTTPS URL to a JPEG, PNG or WebP file up to 25 MB.

## Pricing

Rates in USD. Catalogue timestamp 2026-11-21T02:23:44Z.

- USD 0.03 per image · low, no input images · active
- USD 0.06 per image · medium, no input images · active
- USD 0.1 per image · high, no input images · active
- USD 0.008 per image · very_low, with input images · active
- USD 0.03 per image · low, with input images · active
- USD 0.06 per image · medium, with input images · active
- USD 0.22 per image · high, with input images · active

- Leaving out quality gives high without input images and medium with them; very_low needs input images.
- Every image the generator produces is billed, including an image it withholds after its safety check (a withheld image is not delivered); num_images multiplies the price.

## Examples

### The desert hairpin

From overhead, a yellow rally car rounds a hairpin as a plume of dust follows its tracks.

[Result (image)](https://previews.sociaro.com/shared/promo/gallery/ideogram/desert-rally.webp)
