[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Z-Image Turbo](https://spiral.ai/integrations/dots/z-image-turbo)

# How to Use Z-Image Turbo in dots

Z-Image Turbo turns detailed descriptions into photorealistic images and designs with English or Chinese text. Choose it for prompt-led image creation; Z-Image Turbo LoRA adds custom style adapters.

|  |  |
| --- | --- |
| Model | Z-Image Turbo |
| Available through | fal |
| Category | Image |
| Price | $0.0065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Z-Image Turbo in dots

- Every Monday, use Z-Image Turbo to create a 1024 by 1024 gardening image from the weekly topic I provide in this conversation. Turn the topic into one concrete scene with a clear subject, realistic materials, and natural daylight. Include the generation description with the image for review.
- Each Friday, use Z-Image Turbo to create a 1024 by 1024 bookstore poster draft. Show a different reading nook with warm window light and the exact headline "WEEKEND READING" across the top. Keep the lettering large and include a reminder to proofread the image.
- Every Tuesday, use Z-Image Turbo to generate a 1024 by 1024 product scene concept for a fictional ceramic mug. Rotate between a breakfast table, a studio shelf, and a kitchen counter. Specify the camera angle and soft directional lighting in each description, using eight generation steps.
- Each Thursday, use Z-Image Turbo to create a 1024 by 1024 Chinese tea poster concept. Use the exact headline "每日好茶", a porcelain tea bowl, visible tea leaves, and soft daylight. Change the tabletop material each week and return the image for lettering review.
- Every Monday at 9am: generate a product photo with Z-Image Turbo: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first.

## How to set up Z-Image Turbo in dots

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send dots this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Z-Image Turbo**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/z-image/turbo",
    "input": {
      "prompt": "A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of…"
    }
  }'
```

Then paste one of the prompts above: dots finds Z-Image Turbo on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Z-Image Turbo tools and prices

- [Z Image Turbo · Text to Image](https://spiral.ai/tools/fal/fal-ai/z-image/turbo) (fal): $0.0065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | landscape_4_3 | The size of the generated image. |
| num_inference_steps | 1 to 8 | 8 | The number of inference steps to perform. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| output_format | jpeg, png, webp | png | The format of the generated image. |
| acceleration | none, regular, high | regular | The acceleration level to use. |

## What can you do with Z-Image Turbo in dots?

Produce recurring editorial images and campaign concepts from approved written briefs. A scheduled agent can keep Z-Image Turbo descriptions consistent while deliberately changing the subject, setting, or composition for each assignment.

### Product scene concepts

Explore a product idea from a written description. Specify materials, camera position, surface, and lighting to compare studio and lifestyle treatments.

### Portrait art direction

Draft fictional portraits for a campaign or story. Describe age, expression, clothing, setting, and light to make each direction concrete.

### English and Chinese poster drafts

Create poster concepts with specified English or Chinese lettering. Give the exact headline, its placement, and the scene around it, then proofread the result.

### Editorial cover images

Turn an article's central idea into a concrete photographic scene. Define the subject and composition before generating, especially when the topic involves factual details.

### Website image concepts

Generate imagery for a landing page or feature section from a written brief. Describe where the subject sits and reserve clear space for HTML headings.

### Interior mood studies

Compare room concepts through explicit descriptions of furniture, finishes, daylight, and camera angle. Use the results to discuss a visual direction.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All dots guides](https://spiral.ai/integrations/dots)

## Z-Image Turbo in other agents

- [Amp](https://spiral.ai/integrations/amp/z-image-turbo)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/z-image-turbo)
- [Claude](https://spiral.ai/integrations/claude-desktop/z-image-turbo)
- [Claude Code](https://spiral.ai/integrations/claude-code/z-image-turbo)
- [Cline](https://spiral.ai/integrations/cline/z-image-turbo)
- [Codex](https://spiral.ai/integrations/codex/z-image-turbo)
- [Cursor](https://spiral.ai/integrations/cursor/z-image-turbo)
- [Devin](https://spiral.ai/integrations/devin/z-image-turbo)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/z-image-turbo)
- [Gemini](https://spiral.ai/integrations/gemini/z-image-turbo)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/z-image-turbo)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/z-image-turbo)
- [goose](https://spiral.ai/integrations/goose/z-image-turbo)
- [Grok](https://spiral.ai/integrations/grok/z-image-turbo)
- [Grok Build](https://spiral.ai/integrations/grok-build/z-image-turbo)
- [Hermes](https://spiral.ai/integrations/hermes/z-image-turbo)
- [Instinct](https://spiral.ai/integrations/instinct/z-image-turbo)
- [Manus](https://spiral.ai/integrations/manus/z-image-turbo)
- [Muse](https://spiral.ai/integrations/muse/z-image-turbo)
- [Muse Code](https://spiral.ai/integrations/muse-code/z-image-turbo)
- [n8n](https://spiral.ai/integrations/n8n/z-image-turbo)
- [Notion](https://spiral.ai/integrations/notion/z-image-turbo)
- [OpenClaw](https://spiral.ai/integrations/openclaw/z-image-turbo)
- [opencode](https://spiral.ai/integrations/opencode/z-image-turbo)
- [Perplexity](https://spiral.ai/integrations/perplexity/z-image-turbo)
- [Raycast](https://spiral.ai/integrations/raycast/z-image-turbo)
- [VS Code](https://spiral.ai/integrations/vscode/z-image-turbo)
- [Windsurf](https://spiral.ai/integrations/windsurf/z-image-turbo)
- [Zapier](https://spiral.ai/integrations/zapier/z-image-turbo)

## More dots guides

- [Z-Image Base LoRA](https://spiral.ai/integrations/dots/z-image-base-lora)
- [Z-Image Turbo LoRA](https://spiral.ai/integrations/dots/z-image-turbo-lora)
- [Z-Image Base](https://spiral.ai/integrations/dots/z-image-base)
- [fal Blur](https://spiral.ai/integrations/dots/fal-blur)
- [YouTube Thumbnails](https://spiral.ai/integrations/dots/youtube-thumbnails)
- [fal Desaturate](https://spiral.ai/integrations/dots/fal-desaturate)

## Questions about Z-Image Turbo in dots

**Can dots use Z-Image Turbo?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Z-Image Turbo like any built-in tool.

**How much does Z-Image Turbo cost in dots?**

$0.0065 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use Z-Image Turbo in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs Z-Image Turbo on its own fal account.

**How long does it take to set up Z-Image Turbo in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Z-Image Turbo runs?**

Z-Image Turbo runs in the background. dots starts the run, checks on it and gives you the image when it's ready.

**What is Z-Image Turbo good at?**

Photorealistic images and designs containing English or Chinese text are its clearest strengths. Try portraits, product scene concepts, editorial images, and poster drafts.

**Which languages does Z-Image Turbo support?**

Tongyi specifically documents English and Chinese instruction following and text rendering. Those are the best-supported choices for prompts and lettering inside images.

**How should I write a Z-Image Turbo prompt?**

Use a detailed visual description: identify the subject, its action, the setting, lighting, materials, and framing. For lettering, spell out the exact words and describe where they belong.

**Does Z-Image Turbo support negative prompts?**

No. Describe the desired result directly, such as a plain backdrop, sharp focus, or an empty tabletop.

**How many generation steps should I use?**

Start with eight steps, the generation process documented by Tongyi. Use that as your baseline while refining the description and composition.

