generate

Generate with the distilled few-step Ideogram model (very-low speed tier)

Generates images synchronously using the distilled few-step Ideogram model at the very-low speed tier — the fastest and lowest-cost option. The speed tier controls the number of diffusion steps and the per-image price.

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

post/v1/p-image-ideogram/very-low/generate

Request body

promptstring required

The prompt for image generation. Accepts either natural language or a structured prompt that conforms to the Ideogram 4.0 JSON contract; the server detects which was supplied. See prompt_upsampling for how magic-prompt is applied.

prompt_upsampling'AUTO' | 'ON' | 'OFF'

Determine if MagicPrompt should be used in generating the request or not.

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 only when magic-prompt runs (a natural-language prompt with prompt_upsampling AUTO or ON).

resolution'2048x2048' | '1440x2880' | '2880x1440' | '1664x2496' | '2496x1664' | '1792x2240' | '2240x1792' | '1440x2560' | '2560x1440' | '1600x2560' | '2560x1600' | '1728x2304' | '2304x1728' | '1296x3168' | '3168x1296' | '1152x2944' | '2944x1152' | '1248x3328' | '3328x1248' | '1280x3072' | '3072x1280' | '1024x3072' | '3072x1024' | '1024x1024' | '896x1120' | '1120x896' | '864x1152' | '1152x864' | '832x1248' | '1248x832' | '800x1280' | '1280x800' | '720x1280' | '1280x720' | '720x1440' | '1440x720' | '512x1536' | '1536x512'

The 1K and 2K resolutions supported for Ideogram 4.0 image generation.

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

{
  "prompt_upsampling": "ON",
  "resolution": "2048x2048"
}

Response

Image(s) 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"
}

Changes

Changed in 2 of the 16 revisions of this API.41

Jul 31, 20263cece82bbf1d40See the full diff
- ○
  added the new 1536x512 enum value to the request property resolution (media type: multipart/form-data)
  request-property-enum-value-added
- ○
  added the new 1536x512 enum value to the request property resolution (media type: application/json)
  request-property-enum-value-added
- ○
  added the new 512x1536 enum value to the request property resolution (media type: multipart/form-data)
  request-property-enum-value-added
- ○
  added the new 512x1536 enum value to the request property resolution (media type: application/json)
  request-property-enum-value-added
- ○
  removed the 1024x1024 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1024x3072 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1120x896 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1152x2944 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1152x864 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1248x3328 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1248x832 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1280x3072 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1280x720 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1280x800 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1296x3168 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1440x2560 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1440x2880 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1440x720 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1600x2560 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1664x2496 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1728x2304 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 1792x2240 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2048x2048 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2240x1792 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2304x1728 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2496x1664 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2560x1440 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2560x1600 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2880x1440 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 2944x1152 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 3072x1024 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 3072x1280 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 3168x1296 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 3328x1248 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 720x1280 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 720x1440 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 800x1280 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 832x1248 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 864x1152 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the 896x1120 enum value from the data/items/resolution response property for the response status 200
  response-property-enum-value-removed
Jul 26, 20267e5e0fb307761See the full diff
- ○
  endpoint added
  endpoint-added

Full history