Ideogram V3 Quality

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "ideogram-v3-quality",
    "input": {
      "prompt": "A red fox running through fresh snow at sunrise"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

6 fields in input, required first.

• promptRequired
  string

  The positive prompt for the generation.

• imageOptional
  string

  The image to generate an image.

• styleOptional
  Auto, General, Realistic, DesignDefault Auto

  The style of the generated image.

• mask_imageOptional
  string

  The mask image tells the model where to generate new pixels (white) and where to preserve the original image (black). It acts as a stencil or guide for targeted image editing.

• aspect_ratioOptional
  1:1, 16:9, 9:16, 4:3, 3:4Default 1:1

  The aspect ratio of the generated media.

• reference_imagesOptional
  array

  A list of images to use as style references.