generate

Remix with Ideogram 4.0 asynchronously

Accepts an Ideogram 4.0 remix request for asynchronous processing and returns immediately with a generation_id. Poll GET /v1/generations/{generation_id} to retrieve the result. If a webhook_url is supplied, the generated images are additionally POSTed to it once ready.

post/v1/ideogram-v4/async/remix

Query parameters

webhook_urlstring uri

HTTPS URL that Ideogram delivers the generated result to. Ideogram sends a JSON POST to this URL once all images for the request have finished generating. The body mirrors the synchronous generate response: request_id, created, and a data array containing every generated image (url, prompt, resolution, seed, is_image_safe). Each delivery is signed with Ed25519 and verifiable against the public keys at https://api.ideogram.ai/v1/.well-known/jwks.json. Must be HTTPS; private and loopback hosts and the cloud metadata service are rejected.

Example:https://api.example.com/webhooks/ideogram

Response

Request accepted for asynchronous processing.

generation_idstring required

URL-safe base64 ID of the accepted generation. Matches the generation_id field delivered in the webhook payload, and the generation_id accepted by the generation polling endpoint.

Example response

{
  "generation_id": "generation_id"
}

Changes

Changed in 3 of the 34 revisions of this API.394

Sep 11, 20265dc75f5e8df3391See the full diff
- ▲
  added to the request property allOf list
  request-property-all-of-added
- ▲
  removed the enum value 1024x1024 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1024x3072 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1120x896 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1152x2944 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1152x864 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1248x3328 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1248x832 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1280x3072 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1280x720 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1280x800 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1296x3168 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1440x2560 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1440x2880 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1440x720 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1536x512 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1600x2560 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1664x2496 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1728x2304 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 1792x2240 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2048x2048 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2240x1792 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2304x1728 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2496x1664 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2560x1440 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2560x1600 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2880x1440 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 2944x1152 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 3072x1024 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 3072x1280 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 3168x1296 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 3328x1248 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 512x1536 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 720x1280 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 720x1440 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 800x1280 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 832x1248 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 864x1152 of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value 896x1120 of the request property
  request-property-enum-value-removed
- ○
  the request property type was generalized from string to no type
  request-property-type-generalized
Jul 31, 20263cece82bbf1d2See the full diff
- ○
  added the new 1536x512 enum value to the request property
  request-property-enum-value-added
- ○
  added the new 512x1536 enum value to the request property
  request-property-enum-value-added
Jul 26, 20267e5e0fb307761See the full diff
- ○
  endpoint added
  endpoint-added

Full history