Sign in

v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB
generate

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

Generates images synchronously using the distilled few-step Ideogram model at the low speed tier — fast and low-cost, with a modest quality trade-off. 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/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"
}