Skip to main content
Core.Today
|
Tongyi-MAIFastHigh

Z-Image Turbo (fal)

Tongyi-MAI's Z-Image Turbo, a 6B-parameter text-to-image model tuned for speed โ€” a full image in as few as 8 steps. Priced per output megapixel, so smaller presets cost proportionally less, making it one of the cheapest options for high-volume generation.

9 credits
per image โ€” 12 square_hd, 9 for 4:3 presets, 7 for 16:9 presets, 3 square
Full image in as few as 8 inference steps
Per-megapixel pricing โ€” small presets cost proportionally less
Six aspect-ratio presets from 512x512 to 1024x1024
Up to 4 images per request
Selectable acceleration level

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "fal-ai/z-image/turbo",
  "input": {
    "prompt": "A hyper-realistic close-up portrait of a weathered lighthouse keeper, salt-crusted beard, storm light raking across his face, shot on a Leica M6 with Kodak Portra 400 grain",
    "image_size": "landscape_4_3",
    "num_inference_steps": 8,
    "num_images": 1,
    "output_format": "png"
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-The prompt to generate an image from.
image_sizestringNolandscape_4_3Output size preset. Charged per output megapixel, so smaller presets cost less.
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
num_inference_stepsintegerNo8The number of inference steps to perform (1-8).
num_imagesintegerNo1Number of images to generate (1-4). Charged per image.
seedintegerNo-The same seed and the same prompt will output the same image every time.
enable_safety_checkerbooleanNotrueIf set to true, the safety checker will be enabled.
accelerationstringNoregularThe acceleration level to use.
noneregularhigh
output_formatstringNopngThe format of the generated image.
jpegpngwebp

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Cinematic portrait

Default landscape preset at 8 steps โ€” the fastest, cheapest path to a usable image.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "fal-ai/z-image/turbo",
  "input": {
    "prompt": "A hyper-realistic close-up portrait of a weathered lighthouse keeper, salt-crusted beard, storm light raking across his face, shot on a Leica M6 with Kodak Portra 400 grain",
    "image_size": "landscape_4_3",
    "num_inference_steps": 8,
    "num_images": 1,
    "output_format": "png"
  }
}'

Low-cost square batch

The 512x512 square preset is a quarter of a megapixel, so a 4-image batch costs about the same as one square_hd image.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "fal-ai/z-image/turbo",
  "input": {
    "prompt": "Flat vector icon of a paper airplane, bold single-color silhouette, generous margins, centered",
    "image_size": "square",
    "num_images": 4,
    "output_format": "webp"
  }
}'

Tips & Best Practices

1Pricing follows output megapixels: 'square' (512x512) costs a quarter of 'square_hd' (1024x1024). Pick the smallest preset that fits your use.
2This is a turbo model โ€” num_inference_steps caps at 8, and raising it past the default rarely improves the result.
3Custom width/height is not exposed here; use one of the six presets. For arbitrary dimensions, use prunaai/z-image-turbo on Replicate instead.
4Distinct from prunaai/z-image-turbo: that is Pruna's optimised build with width/height inputs, this is the original at half the cost per megapixel.

Use Cases

High-volume thumbnail and variation generation
Rapid prompt iteration before committing to a premium model
Cost-sensitive batch pipelines
Real-time or interactive image previews