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

Perplexity · ImageReleased 2025-09-08

How to Use HunyuanImage 2.1 in Perplexity

HunyuanImage 2.1 turns detailed text descriptions into 2K images for illustrations, photographic concepts, and poster drafts. It supports Chinese and English prompts, with an optional refiner to improve clarity and reduce artifacts.

Prompts to try with HunyuanImage 2.1 in Perplexity

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

Use HunyuanImage 2.1 to create a 2048 × 2048 photographic concept of a handmade ceramic teapot on dark linen, soft window light from the left, close framing, and visible clay texture.

HunyuanImage 2.1Perplexity
Try asking
  • Use HunyuanImage 2.1 for a square poster draft at 2048 × 2048: a small bookstore at dusk, warm windows, dark green storefront, and the words 'OPEN LATE' above the door.

  • Use HunyuanImage 2.1 to illustrate this idea at 2048 × 2048: saving time feels like finding an extra hour. Show a gardener resting beside an oversized clock, in a painted editorial style.

  • Use HunyuanImage 2.1 to generate 2560 × 1536 landscape artwork of a quiet mountain observatory at dawn. Put the building on the right, leave open sky on the left, and enable refinement.

  • Use HunyuanImage 2.1 with this Chinese prompt at 2048 × 2048: 雨后的江南小巷,一位穿黄色雨衣的人站在石桥上,远处是白墙黑瓦,柔和晨光,水彩插画。

How to set up HunyuanImage 2.1 in Perplexity

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

Use the Perplexity connector

  1. Add a remote connector

    In Perplexity, open Plugins in the sidebar (or Customize › Connectors if you don't see Plugins yet). Choose Add custom › Add MCP connector, then Remote. Name it Spiral and paste this MCP server URL:

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

    Select the Spiral card on the Plugins page to start sign-in. Spiral opens: sign in, pick the organization and click Authorize. No API key.

Use the Spiral skill

  1. Send Perplexity 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 HunyuanImage 2.1

    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/hunyuan-image/v2.1/text-to-image",
        "input": {
          "prompt": "A cute, cartoon-style anthropomorphic penguin plush toy, standing in a painting studio, wearing a red knitted scarf and beret."
        }
      }'

Then paste one of the prompts above: Perplexity finds HunyuanImage 2.1 on Spiral, shows the price and runs it.

HunyuanImage 2.1 providers and prices

Spiral runs HunyuanImage 2.1 through fal. Open a card for today's price, with every fee included.

falImage
Hunyuan Image
fal-ai/hunyuan-image/v2.1/text-to-image

Settings you can ask for

HunyuanImage 2.1 works from your prompt. Ask Perplexity for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

The negative prompt to guide the image generation away from certain concepts.

Number of images1 to 41

The number of images to generate.

Number of inference steps1 to 5028

Number of denoising steps.

Guidance scale1 to 203.5

Controls how much the model adheres to the prompt. Higher values mean stricter adherence.

Seeda whole number

Random seed for reproducible results. If None, a random seed is used.

Use reprompton or offon

Enable prompt enhancement for potentially better results.

Use refineron or offoff

Enable the refiner model for improved image quality.

Output formatjpeg or pngpng

The format of the generated image.

Every API field of Hunyuan Image is on its tool page: open its card above.

What can you do with HunyuanImage 2.1 in Perplexity?

Turn a written idea into photographic concepts, illustrations, or poster drafts with HunyuanImage 2.1. Use the conversation to specify composition, lighting, and style before generating 2K artwork.

Article illustrations

Turn an article's central idea into a 2K illustration. Specify a concrete visual metaphor, the main subject, and space for a headline added during layout.

Photographic campaign concepts

Explore a proposed scene before arranging a shoot. Describe the setting, camera viewpoint, materials, and light so a reviewer can judge the direction.

Poster drafts

Develop poster concepts with a short headline integrated into the artwork. Review the generated lettering before using the design.

Website artwork

Create landscape artwork for a page header from a written design brief. Define the focal point and leave a quiet area for interface text.

Character concept illustrations

Explore a character's clothing, expression, pose, and setting through detailed descriptions. Use the results as concepts for an illustrator to assess.

Abstract cover artwork

Develop cover concepts built from geometric shapes, materials, and a specified palette. Generate square artwork at 2048 × 2048.

Chinese-language creative briefs

Write the scene directly in Chinese to develop illustrations or campaign concepts. Specify visual details in the original brief rather than translating it first.

Questions about HunyuanImage 2.1 in Perplexity

Can Perplexity use HunyuanImage 2.1?

Yes. Add Spiral to Perplexity as an MCP server, and Perplexity can find and run HunyuanImage 2.1 like any built-in tool.

How much does HunyuanImage 2.1 cost in Perplexity?

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

Do I need a fal account to use HunyuanImage 2.1 in Perplexity?

No. Spiral runs HunyuanImage 2.1 on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up HunyuanImage 2.1 in Perplexity?

About two minutes: add a remote connector, then sign in to Spiral and approve.

Does Perplexity wait while HunyuanImage 2.1 runs?

HunyuanImage 2.1 runs in the background. Perplexity starts the run, checks on it and gives you the image when it's ready.

What is HunyuanImage 2.1 useful for?

Use it for photographic concepts, digital illustrations, abstract artwork, and poster drafts with text. Tencent demonstrates these styles with prompt enhancement enabled.

What resolution should I generate?

Generate at the documented 2K sizes, such as 2048 × 2048 for square artwork or 2560 × 1536 for landscape compositions. Tencent warns that 1K generation produces artifacts.

Can I write prompts in Chinese?

Yes. HunyuanImage 2.1 natively supports both Chinese and English prompts.

How should I write a useful prompt?

Describe the subject, its appearance, placement, surroundings, lighting, and visual style. Favor a precise scene description over a short string of adjectives.

When should I enable the refiner?

Enable it when clarity and artifact reduction matter, such as when preparing a selected concept for review. Tencent describes it as a second stage that improves image quality and clarity.

Get started

Start using HunyuanImage 2.1 in Perplexity

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

Paste this into Perplexity:

Set up Perplexity

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