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

Perplexity · ImageReleased 2025-09-28

How to Use HunyuanImage 3.0 in Perplexity

HunyuanImage 3.0 turns detailed text briefs into photorealistic scenes, illustrations, and graphics with lettering. Its original checkpoint benefits from an explicit visual description because it does not rewrite prompts itself.

Prompts to try with HunyuanImage 3.0 in Perplexity

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

Use HunyuanImage 3.0 to create a square image, 1024 pixels on each side, of a ceramicist lifting a wet bowl from a pottery wheel. Make it photographic, frame the hands and bowl closely, and use soft daylight from a window on the left.

HunyuanImage 3.0Perplexity
Try asking
  • Use HunyuanImage 3.0 to draft a square neighborhood book-fair poster. Show an outdoor table of books beneath an oak tree, with the exact title "BOOK FAIR" centered at the top in dark green lettering.

  • Use HunyuanImage 3.0 to create a landscape presentation cover, 1280 pixels wide and 768 pixels tall, about rebuilding trust. Show two people repairing a wooden bridge, with the action on the right and clear sky on the left for my title.

  • Use HunyuanImage 3.0 to create a photographic concept for a matte red insulated bottle on a pale stone table. Use a three-quarter view, soft morning light from the right, and a quiet background with no lettering.

  • Use HunyuanImage 3.0 to draft a square tea-shop poster with the exact text "春茶" near the top. Show a white porcelain cup and fresh green tea leaves on a wooden table, and preserve the Chinese lettering exactly.

How to set up HunyuanImage 3.0 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 3.0

    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/v3/text-to-image",
        "input": {
          "prompt": "200mm telephoto through crowd gaps; subject laughing, candid; creamy background compression, color pop from a single bold garment, catchlight in eyes."
        }
      }'

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

HunyuanImage 3.0 providers and prices

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

falImage
Hunyuan Image
fal-ai/hunyuan-image/v3/text-to-image

Settings you can ask for

HunyuanImage 3.0 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 207.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.

Output formatjpeg or pngpng

The format of the generated image.

Enable prompt expansionon or offoff

Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.

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

What can you do with HunyuanImage 3.0 in Perplexity?

Turn a written idea into a photograph concept, illustration, or graphic with specified lettering. Use the conversation to settle the subject, composition, and lighting before asking for the image.

Article illustrations

Turn an article's central idea into a concrete scene. Describe the subject, action, setting, and composition, with open space for a headline added later.

Product concept photography

Explore a proposed product's shape, materials, setting, and lighting from a written brief. Use the images to discuss a concept before arranging a shoot.

Event poster drafts

Develop a poster around a specific scene and a short quoted title. State where each text element belongs and check the lettering before production.

Interface design studies

Explore a static screen's visual direction with explicit regions, element counts, colors, and quoted labels. Use the result as a design reference during implementation.

Campaign art direction

Compare visual treatments of the same written campaign idea by changing the setting, camera angle, or lighting in separate generations.

Presentation cover images

Translate an abstract presentation topic into a specific visual metaphor, such as a repaired bridge for restoring trust. Describe the metaphor's visible objects and their relationships.

Questions about HunyuanImage 3.0 in Perplexity

Can Perplexity use HunyuanImage 3.0?

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

How much does HunyuanImage 3.0 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 3.0 in Perplexity?

No. Spiral runs HunyuanImage 3.0 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 3.0 in Perplexity?

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

Does Perplexity wait while HunyuanImage 3.0 runs?

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

What is HunyuanImage 3.0 good at?

Detailed photorealistic scenes, concept illustrations, and graphics containing text are useful starting points. Tencent highlights prompt adherence, concept interpretation, and text rendering as strengths.

How should I write a HunyuanImage 3.0 prompt?

Start with the subject and action, then add the setting and style. Specify the framing, positions, and lighting you want instead of asking for a generally attractive image.

Can HunyuanImage 3.0 put words inside an image?

Yes, text rendering is one of Tencent's stated strengths. Put the exact words in double quotes, describe their position, and proofread the result before using it.

Which languages should I use for prompts?

English and Chinese are supported by Tencent's bilingual training descriptions. For lettering, write the exact text you want to appear and keep its original language.

What image sizes does Tencent document?

Tencent demonstrates 1024 × 1024 generation and documents requests such as 1280 × 768 and 16:9. Those are documented examples, rather than a verified maximum resolution.

Get started

Start using HunyuanImage 3.0 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