Grok Imagine Image

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": "grok-imagine-image",
    "input": {
      "prompt": "A cinematic, ultra-detailed scene of a futuristic forest landscape at golden daylight...."
    }
  }'

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

3 fields in input, required first.

• promptRequired
  string

  Text prompt for image generation or editing

• imageOptional
  URL

  Input image for editing. When provided, the model edits this image based on the prompt. Supports jpg, jpeg, png, webp.

• aspect_ratioOptional
  1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, autoDefault 1:1

  Aspect ratio of the generated image. Ignored when editing an image.