Sign in

e7f5f98d7fdb

latestOpenAPI 3.0.22026-08-13115250435.7 KB
generate

Generate with Ideogram 4.0 (Transparent Background)

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.

post/v1/ideogram-v4/generate-transparent

Request body

text_promptstring

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

seedinteger nullable

Random seed for reproducibility.

magic_prompt_system_prompt_config_idstring

A base64url-encoded magic prompt system prompt config ID to use for this request. Honored when text_prompt is supplied. Ignored when json_prompt is supplied.

aspect_ratio'AUTO' | '1x4' | '1x3' | '1x2' | '9x16' | '10x16' | '2x3' | '3x4' | '4x5' | '1x1' | '5x4' | '4x3' | '3x2' | '16x10' | '16x9' | '2x1' | '3x1' | '4x1'

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_resolution'1K' | '2K' | '4K' | '8K'

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.

rendering_speed'TURBO' | 'DEFAULT' | 'QUALITY'

The rendering speed to use. Defaults to DEFAULT.

enable_copyright_detectionboolean nullable

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.

Example request

{
  "json_prompt": {
    "high_level_description": "high_level_description",
    "style_description": {
      "photo": "photo",
      "art_style": "art_style",
      "medium": "medium",
      "aesthetics": "aesthetics",
      "lighting": "lighting",
      "color_palette": [
        "#FFD700",
        "#FFD700"
      ]
    },
    "compositional_deconstruction": {
      "background": "background",
      "elements": [
        {
          "bbox": [
            0,
            0,
            1000,
            1000
          ],
          "type": "obj",
          "desc": "desc",
          "color_palette": [
            "#FFD700",
            "#FFD700"
          ]
        },
        {
          "bbox": [
            0,
            0,
            1000,
            1000
          ],
          "type": "obj",
          "desc": "desc",
          "color_palette": [
            "#FFD700",
            "#FFD700"
          ]
        }
      ]
    },
    "tags": [
      "tags",
      "tags"
    ]
  }
}

Response

Image generated successfully.

response_type'url'

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

createdstring date-time required

The time the request was created.

Example response

{
  "data": [
    {
      "seed": 12345,
      "prompt": "prompt",
      "resolution": "1024x1024",
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
      "is_image_safe": true
    },
    {
      "seed": 12345,
      "prompt": "prompt",
      "resolution": "1024x1024",
      "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
      "is_image_safe": true
    }
  ],
  "created": "2000-01-23T04:56:07+00:00",
  "response_type": "url"
}