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.
Prompts to try with Z-Image Turbo in dots
Copy an example into dots, or ask in your own words.
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
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- 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
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- 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
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Z-Image Turbo
One request; the result comes back by polling or a webhook.
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.
Z-Image Turbo providers and prices
Spiral runs Z-Image Turbo through fal. Open a card for today's price, with every fee included.
$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
Z-Image Turbo works from your prompt. Ask dots for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of inference steps | 1 to 8 | 8 | The number of inference steps to perform. |
| Seed | a whole number | The same seed and the same prompt given to the same version of the model will output the same image every time. | |
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Output format | jpeg, png, or webp | png | The format of the generated image. |
| Acceleration | none, regular, or high | regular | The acceleration level to use. |
| Enable prompt expansion | on or off | off | Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request. |
Every API field of Z Image Turbo · Text to Image is on its tool page: open its card above.
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.
More on Z-Image Turbo and dots
Overview
Z-Image Turbo in other agents
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.
Start using Z-Image Turbo in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


