Generate with Ideogram 4.0 (Transparent Background) | Ideogram

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.

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.

Authentication

Api-Keystring

API key for access control. Use in the header with the name “Api-Key”

Request

A request to generate a transparent-background image with Ideogram 4.0.

text_promptstringOptional

A natural-language prompt for image generation. When supplied, magic-prompt is enabled automatically. Mutually exclusive with json_prompt.

json_promptobjectOptional

A structured prompt that conforms to the Ideogram 4.0 JSON contract. When supplied, magic-prompt is disabled and the structured prompt is consumed by the diffusion model directly, except that compositional_deconstruction.background is replaced with a transparent-background directive. Mutually exclusive with text_prompt.

aspect_ratioenumOptionalDefaults to AUTO

The aspect ratio for an Ideogram 4.0 magic prompt. AUTO lets the model select the most suitable ratio from the prompt; any other value pins the ratio. The non-AUTO values are the buckets the 4.0 model supports.

output_resolutionenumOptionalDefaults to 1K

The output resolution tier for the generated image. Tiers are total-pixel budgets matching a square of the named size (for example, 8K delivers at most 8192x8192 total pixels); wide and tall aspect ratios keep the same pixel budget, so a single dimension may exceed the named size. Defaults to 1K.

Allowed values:

rendering_speedenumOptionalDefaults to DEFAULT

The rendering speed to use. Defaults to DEFAULT.

Allowed values:

enable_copyright_detectionboolean or nullOptional

Optional. Opt this request into post-generation copyright detection (Hive likeness + logo checks). The effective gate is the OR of this field and the organization’s copyright_detection_enabled setting on /api. See GenerateImageRequestV3 for details.

Response

Image generated successfully.

createddatetime

The time the request was created.

datalist of objects

A list of ImageObjects that contain the generated image(s).

response_typeenumOptional

Discriminator for the postGenerateDesignV4 oneOf response. Always "url" for this shape.

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

$	curl -X POST https://api.ideogram.ai/v1/ideogram-v4/generate-transparent \
>	-H "Api-Key: <apiKey>" \
>	-H "Content-Type: multipart/form-data" \
>	-F text_prompt="A logo for Ideogram Coffee." \
>	-F aspect_ratio="1x1" \
>	-F output_resolution="4K" \
>	-F rendering_speed="TURBO"

1	{
2	"created": "2000-01-23 04:56:07+00:00",
3	"data": [
4	{
5	"prompt": "A logo for Ideogram Coffee.",
6	"resolution": "4096x4096",
7	"is_image_safe": true,
8	"seed": 12345,
9	"url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89"
10	}
11	]
12	}