edit-workflow

Ad Variations

Changed on

Creates on-brand variations of an ad along one axis, preserving logos, brand colors, the product, and all on-image text. Upload the source creative as image using multipart/form-data and choose a variation_type. Returns a generation_id; poll GET /v2/generations/{generation_id} or supply a webhook_url.

post/v2/tool/ad-variations

Request

  • Base URL: https://api.ideogram.ai
  • URL: https://api.ideogram.ai/v2/tool/ad-variations
  • Auth: API key in header Api-Key

Response

Ad variation accepted for asynchronous processing.

generation_idstring required

URL-safe base64 ID accepted by the generation polling endpoint.

Changes

  • 3ee00ffa31d6Revision changes
    • breaking

      removed the media type application/json from the request body

    • breaking

      the request property became required

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      api operation id post_ad_variations removed and replaced with editWorkflow_post_ad_variations

    • 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

  • 919a744eb885Revision changes
    • info

      added the new optional request property / (media type: multipart/form-data)

    • info

      added the new optional request property / (media type: application/json)