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

# How to Use Z-Image Turbo in Muse

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 Muse

- Use Z-Image Turbo to create a 1024 by 1024 product concept image: a matte green insulated bottle on a pale stone countertop, water droplets on the surface, soft light from the left, and an eye-level camera. Use eight generation steps and keep the bottle's label area plain.
- Use Z-Image Turbo to create a square poster draft, 1024 pixels on each side. Show a small neighborhood bookstore at dusk, warm light through the windows, and the exact headline "READ TOGETHER" above the storefront. Describe the lettering as large cream-colored block capitals.
- Use Z-Image Turbo to create a 1024 by 1024 tea shop poster. Show a white porcelain cup on a dark wooden table, steam against a softly lit background, and the exact Chinese text "春茶上市" centered across the top in dark green lettering.
- Use Z-Image Turbo to create a fictional portrait at 1024 by 1024: a retired boatbuilder with silver hair, a navy work jacket, and a relaxed expression, seated beside a workshop window. Show natural skin texture, soft side lighting, and an out-of-focus wooden hull behind him.
- 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 Muse

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

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

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

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

1. **Send Muse 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 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: Muse finds Z-Image Turbo on Spiral, shows the price and runs it.

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

## 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 Muse?

Turn an idea into a photographic scene or an English and Chinese poster draft during a conversation. Your chat agent can help specify the subject, lighting, composition, and lettering before asking Z-Image Turbo to generate it.

### 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 Muse guides](https://spiral.ai/integrations/muse)

## 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)
- [dots](https://spiral.ai/integrations/dots/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 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 Muse guides

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

## Questions about Z-Image Turbo in Muse

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

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

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

$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 Muse plan is separate.

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

You need no fal account. Muse 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 Muse?**

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

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

Z-Image Turbo runs in the background. Muse 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.

