Image 01

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": "minimax-image-01",
    "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

5 fields in input, required first.

• promptRequired
  string

  Text description of the image, max length 1500 characters.

• seedOptional
  integer

  Random seed. Using the same seed and parameters produces reproducible images. If not provided, a random seed is generated for each image.

• sizeOptional
  stringDefault 1024*1024

  Specify the width and height pixel values of the generated image. Must be divisible by 8

• num_imagesOptional
  integerDefault 1

  The number of images to generate.

• prompt_optimizerOptional
  booleanDefault false

  Enable automatic optimization of prompt.