---
title: "Generate with the distilled few-step Ideogram model (medium speed tier)"
method: POST
path: "/v1/p-image-ideogram/medium/generate"
tags: ["generate"]
---

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

`POST /v1/p-image-ideogram/medium/generate`

Generates images synchronously using the distilled few-step Ideogram
model at the medium speed tier — the balanced default of speed, cost, and
quality. 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.

## Request body

- GenerateImageRequestPImage — Request body for the distilled few-step Ideogram generate endpoints. The speed/quality tier is selected by the URL path, not this body. Supply a `prompt`: either natural language or a structured Ideogram 4.0 JSON prompt (the server detects which). The base model is always the distilled few-step Ideogram model; a custom registry model cannot be selected on these endpoints.
  - `prompt` string, 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.
  - `seed` integer, nullable — Random seed for reproducibility.
  - `magic_prompt_system_prompt_config_id` string — 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_detection` boolean, 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.

## Response `200`

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

---

[API](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.net/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/versions/bcc2d45be91e/schema)