Z-Image Turbo

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": "z-image-turbo",
    "input": {
      "prompt": "A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted wit..."
    }
  }'

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

17 fields in input, required first.

• promptRequired
  string

  Text prompt for image generation

• heightOptional
  integerDefault 1024

  Height of the generated image

• widthOptional
  integerDefault 1024

  Width of the generated image

• num_inference_stepsOptional
  integerDefault 8

  Number of inference steps.

• guidance_scaleOptional
  numberDefault 0

  Guidance scale. Should be 0 for Turbo models

• seedOptional
  integer

  Random seed. Set for reproducible generation

• go_fastOptional
  booleanDefault false

  Unused compatibility field; this endpoint always runs the bf16 model.

• output_formatOptional
  png, jpg, webpDefault jpg

  Format of the output images

• output_qualityOptional
  integerDefault 80

  Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for.png outputs

• num_outputsOptional
  integerDefault 1

  Number of output images to generate (currently only 1 is supported).

• safety_toleranceOptional
  integerDefault 2

  Unused compatibility field for Flux-style clients; this model has no safety checker.

• model_versionOptional
  string

  Unused compatibility field; this endpoint always runs Z-Image-Turbo.

• negative_promptOptional
  string

  Unused compatibility field; Z-Image-Turbo is guidance-free (guidance_scale=0) and does not use negative prompts.

• aspect_ratioOptional
  string

  Unused compatibility field; set width/height directly instead.

• megapixelsOptional
  string

  Unused compatibility field; set width/height directly instead.

• disable_safety_checkerOptional
  booleanDefault true

  Unused compatibility field; this model has no safety checker.

• enable_safety_checkerOptional
  booleanDefault false

  Unused compatibility field; this model has no safety checker.