images-generate

Generate with Nano Banana 2.1

Changed on

Generate images with Nano Banana 2.1. Optionally upload source images as images using multipart/form-data to edit them with the prompt. Returns results directly by default; set async or supply a webhook_url to get a generation_id and poll GET /v2/generations/{generation_id}.

post/v2/image/generate/nano-banana-2-1

Request

  • Base URL: https://api.ideogram.ai
  • URL: https://api.ideogram.ai/v2/image/generate/nano-banana-2-1
  • Auth: API key in header Api-Key

Query parameters

dry_runboolean

When true, the request is validated and priced but not run: nothing is generated, stored, or billed, and no safety review is performed. The response is a PriceQuote object instead of the usual response for this endpoint. Send exactly the request you would send to generate, so the quote reflects the same options.

Response

The generated images (synchronous requests), or an acknowledgement to poll with GET /v2/generations/{generation_id} (async requests).

generation_idstring required

URL-safe base64 ID of the generation. Use it to poll GET /v2/generations/{generation_id}.

seedinteger required

Random seed. Set for reproducible generation.

Changes

  • 3ee00ffa31d6Revision changes
    • breaking

      removed the media type application/json from the request body

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      api operation id post_generate_image_v2_nano_banana21 removed and replaced with imagesGenerate_post_generate_image_v2_nano_banana21

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      request body became optional

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

  • 3a549263f2c5Revision changes
    • info

      endpoint added