Sign in
edit-workflow

Edit a product image using an instruction and ordered references

Edits the base image while preserving details the instruction does not change. Image 1 is the base; reference images are numbered from image 2 in the supplied order. Resolve image mentions to these numbers before submitting. Descriptions identify the selected view or reference.

Poll GET /v1/generations/{generation_id} with the returned generation_id until the workflow completes or fails.

post/v2/tool/skechers-style-editor

Request body

resolved_instructionstring required

Edit instructions with known image mentions resolved to image numbers.

base_descriptionstring

Optional description of the selected base image or named view.

reference_descriptionsstring[]

One nonempty description per reference image, in the same order.

aspect_ratiostring

Output ratio. When omitted, derive the nearest supported ratio from the base.

base_generation_size'1K' | '2K' | '4K'

Output resolution tier; corresponds to the app's low, medium, and high settings.

num_images1 | 2 | 4

Number of edited images to create.

privateboolean

When true or omitted, the output is kept private to your account. Set to false to publish the output to the public feed. Enterprise accounts always generate privately.

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 request

{
  "base_description": "base_description",
  "aspect_ratio": 61,
  "private": true,
  "reference_asset_identifiers": [
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    },
    {
      "asset_type": "RESPONSE",
      "asset_id": "7uS_VESkRI6O3-sVgHQp_A"
    }
  ],
  "webhook_url": "https://api.example.com/webhooks/ideogram",
  "base_generation_size": "2K",
  "base_asset_identifier": "",
  "reference_descriptions": [
    "reference_descriptions",
    "reference_descriptions",
    "reference_descriptions",
    "reference_descriptions",
    "reference_descriptions"
  ],
  "resolved_instruction": "resolved_instruction",
  "num_images": 0
}

Response

Style edit accepted for asynchronous processing.

generation_idstring required

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

Example response

{
  "generation_id": "generation_id"
}

Changes