Create Image Generation

Changed on Sep 22, 2026

Start an image generation with the selected model.

post/v1/flows/image

Request

Base URL
https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
URL
https://api.elevenlabs.io/v1/flows/image
Auth
none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body

Example request

{
  "webhook": {
    "ids": [
      "Q8mVr2LpXcT4nB6yJdKw"
    ]
  },
  "prompt": "A corgi in a tiny lifeguard chair on a sunlit beach at golden hour, photorealistic",
  "images": [
    {
      "generation_id": "JWr5N6X9ZTqf8jD2LmQb"
    }
  ],
  "mask": {
    "generation_id": "JWr5N6X9ZTqf8jD2LmQb"
  }
}

Response

Successful Response

idstring required

The unique identifier of the generation. Pass it to the corresponding GET endpoint to retrieve the output.

status'pending' required

A newly created generation is always pending.

Example response

{
  "id": "JWr5N6X9ZTqf8jD2LmQb",
  "status": "pending"
}

Changes

Sep 22, 20266fb9be1a19f5 Revision changes
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- breaking
  the request property /////// became required
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value all was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
- info
  the request property default value ids was removed
Sep 19, 2026e1bb68b2a601 Revision changes
- info
  added gpt-image-2.5-flare gpt-image-2.5-sunburst mapping keys to the request discriminator
- info
  added to the request body oneOf list

Operation history (3 revisions)