Spiral gives your agent every tool with one account. Browse the tools →

Factory Droid · ImageReleased 2025-11-26

How to Use Z-Image Turbo in Factory Droid

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 Factory Droid

Copy an example into Factory Droid, or ask in your own words.

Read the homepage copy and layout in this project. Use Z-Image Turbo to create a 1024 by 1024 photographic image of a ceramic pour-over dripper on a walnut counter, soft morning window light, visible glaze texture, and the subject in the right half. Add it to the page with suitable alt text.

Z-Image TurboFactory Droid
Try asking
  • Use Z-Image Turbo to create a 1024 by 1024 editorial image for this project's urban gardening article: a weathered terracotta pot of basil on an apartment balcony, brick buildings behind it, soft overcast light, and a close camera angle. Save it with the article's assets and add descriptive alt text.

  • Check the event page's English and Chinese headings. Use Z-Image Turbo to generate a 1024 by 1024 poster draft showing a tea cup viewed from above, with the exact headings placed above and below it. Keep the page's actual event details as HTML text.

  • 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. Save the result in ./assets.

  • Make four logo concepts for a coffee brand called "Northline" with Z-Image Turbo.

How to set up Z-Image Turbo in Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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.

    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.

    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: Factory Droid 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.

falImage
Z Image Turbo · Text to Image
fal-ai/z-image/turbo

Settings you can ask for

Z-Image Turbo works from your prompt. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of inference steps1 to 88

The number of inference steps to perform.

Seeda 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 images1 to 41

The number of images to generate.

Output formatjpeg, png, or webppng

The format of the generated image.

Accelerationnone, regular, or highregular

The acceleration level to use.

Enable prompt expansionon or offoff

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 Factory Droid?

Create photographic assets and bilingual graphic drafts alongside the project you are building. Your coding agent can turn repository copy and layout requirements into detailed Z-Image Turbo briefs, then place the results in the interface.

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.

Questions about Z-Image Turbo in Factory Droid

Can Factory Droid use Z-Image Turbo?

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

How much does Z-Image Turbo cost in Factory Droid?

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

Do I need a fal account to use Z-Image Turbo in Factory Droid?

No. Spiral runs Z-Image Turbo on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Z-Image Turbo in Factory Droid?

About two minutes: add the server, then sign in, then check it.

Does Factory Droid wait while Z-Image Turbo runs?

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

Get started

Start using Z-Image Turbo in Factory Droid

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Factory Droid:

Set up Factory Droid

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options