v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB

generate

Image-to-image with Ideogram 4.0 asynchronously via webhook

Accepts an Ideogram 4.0 image-to-image request for asynchronous processing and returns immediately with a request_id. The generated images are POSTed to the supplied webhook_url once ready.

post/v1/ideogram-v4/async/image-to-image

Query parameters

webhook_urlstring uri required

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 delivery.

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"
}