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

Gemini · ImageReleased 2025-11-26

How to Use Z-Image Turbo in Gemini

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 Gemini

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

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.

Z-Image TurboGemini
Try asking
  • 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 Gemini

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

Use the Gemini connector

  1. Open Connected Apps

    On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.

  2. Add Spiral as a custom app

    Under Custom apps, click Add a custom app and paste this MCP server URL:

    https://api.spiral.ai/mcp
  3. Sign in to Spiral and approve

    Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.

Use the Spiral skill

  1. Send Gemini 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: Gemini 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 Gemini 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 Gemini?

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.

Questions about Z-Image Turbo in Gemini

Can Gemini use Z-Image Turbo?

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

How much does Z-Image Turbo cost in Gemini?

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

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

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 Gemini?

About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.

Does Gemini wait while Z-Image Turbo runs?

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

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

Paste this into Gemini:

Set up Gemini

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