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.
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
- 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
- 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
- Send Perplexity this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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.
$0.13 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
HunyuanImage 3.0 works from your prompt. Ask Perplexity for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Negative prompt | what to leave out, in words | The negative prompt to guide the image generation away from certain concepts. | |
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Number of inference steps | 1 to 50 | 28 | Number of denoising steps. |
| Guidance scale | 1 to 20 | 7.5 | Controls how much the model adheres to the prompt. Higher values mean stricter adherence. |
| Seed | a whole number | Random seed for reproducible results. If None, a random seed is used. | |
| Output format | jpeg or png | png | The format of the generated image. |
| Enable prompt expansion | on or off | off | 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.
More on HunyuanImage 3.0 and Perplexity
Overview
HunyuanImage 3.0 in other agents
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.
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 https://spiral.ai/SKILL.md


