---
title: "Generate with Ideogram 4.0 (Transparent Background)"
method: POST
path: "/v1/ideogram-v4/generate-transparent"
tags: ["generate"]
---

# Generate with Ideogram 4.0 (Transparent Background)

`POST /v1/ideogram-v4/generate-transparent`

Generates images with a transparent background synchronously using the
Ideogram 4.0 model. The result is delivered as a PNG with an alpha
channel.

All Ideogram 4.0 aspect ratios are supported, including `AUTO`, which
lets the model select the most suitable ratio from the prompt.

`output_resolution` selects the delivered resolution tier. Tiers are
total-pixel budgets: wide and tall aspect ratios keep the same pixel
budget as the square of the named size, so a single dimension may
exceed it. The response reports the final delivered resolution.

Image links are available for a limited period of time; if you would
like to keep the image, you must download it.

## Headers

- `Api-Key` string, required

## Response `200`

Image generated successfully.

- ImageGenerationResponseV4 — The response which contains information about the generated image, including the download link. Images links are available for a limited period of time; if you would like to keep the image, you must download it.
  - `response_type` 'url' — Discriminator for the postGenerateDesignV4 oneOf response. Always "url" for this shape.
  - `created` string, date-time, required — The time the request was created.
  - `data` ImageGenerationObjectV4[], required — A list of ImageObjects that contain the generated image(s).
    - `url` string, uri, nullable — The direct link to the image generated.
    - `prompt` string, required — The prompt used for the generation. This may be different from the original prompt.
    - `resolution` string, required — The output resolution of the image, in the format WIDTHxHEIGHT (e.g. 1024x1024). Not limited to the request resolution presets, since some endpoints accept custom output sizes.
    - `is_image_safe` boolean, required — Whether this request passes safety checks. If false, the url field will be empty.
    - `seed` integer, required — Random seed. Set for reproducible generation.

## Other responses

- `400` — Invalid input provided.
- `401` — Not authorized.
- `422` — Prompt failed the safety check.
- `429` — Too many requests.

## Changes

> 7 revisions in range; 3 could not be searched.

- **2026-08-14** `206df39ff5d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ideogram/apis/api-reference/changes/v1/ideogram-v4/generate-transparent/post.md)

---

[API](https://skmtc.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)