[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [HunyuanImage 3.0](https://spiral.ai/integrations/instinct/hunyuanimage-3-0)

# How to Use HunyuanImage 3.0 in Instinct

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.

|  |  |
| --- | --- |
| Model | HunyuanImage 3.0 |
| Available through | fal |
| Category | Image |
| Price | $0.13 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with HunyuanImage 3.0 in Instinct

- Every Monday, use HunyuanImage 3.0 to create a square editorial image for the week's approved newsletter topic. Translate the topic into one concrete scene, specify the main action and lighting, and leave all lettering out.
- For each approved event announcement, use HunyuanImage 3.0 to draft a square poster. Put the supplied event title in double quotes, specify its position above the central scene, and include a reminder to proofread the generated lettering.
- Each Friday, use HunyuanImage 3.0 to create a landscape cover draft, 1280 pixels wide and 768 pixels tall, for the next presentation topic. Put the visual metaphor on the right and leave the left side clear for a title.
- When a new product concept is approved, use HunyuanImage 3.0 to make a square photographic study. Spell out the proposed shape and materials, use a three-quarter camera angle and soft light from the left, and label the result as concept art.
- On the first business day of each month, use HunyuanImage 3.0 to draft an image for the approved campaign theme. Keep the supplied palette and photographic style, describe one clear action, and record the complete image description for review.

## How to set up HunyuanImage 3.0 in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
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.

```bash
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: Instinct finds HunyuanImage 3.0 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## HunyuanImage 3.0 tools and prices

- [Hunyuan Image](https://spiral.ai/tools/fal/fal-ai/hunyuan-image/v3/text-to-image) (fal): $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

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | The negative prompt to guide the image generation away from certain concepts. |
| image_size |  | square_hd | The desired size of the generated image. |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| num_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 |  | — | Random seed for reproducible results. If None, a random seed is used. |

## What can you do with HunyuanImage 3.0 in Instinct?

Produce recurring illustration drafts from fresh editorial or campaign briefs. Have the agent preserve the written art direction and flag wording or composition for review before each image is used.

### 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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## HunyuanImage 3.0 in other agents

- [Amp](https://spiral.ai/integrations/amp/hunyuanimage-3-0)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/hunyuanimage-3-0)
- [Claude](https://spiral.ai/integrations/claude-desktop/hunyuanimage-3-0)
- [Claude Code](https://spiral.ai/integrations/claude-code/hunyuanimage-3-0)
- [Cline](https://spiral.ai/integrations/cline/hunyuanimage-3-0)
- [Codex](https://spiral.ai/integrations/codex/hunyuanimage-3-0)
- [Cursor](https://spiral.ai/integrations/cursor/hunyuanimage-3-0)
- [Devin](https://spiral.ai/integrations/devin/hunyuanimage-3-0)
- [dots](https://spiral.ai/integrations/dots/hunyuanimage-3-0)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/hunyuanimage-3-0)
- [Gemini](https://spiral.ai/integrations/gemini/hunyuanimage-3-0)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/hunyuanimage-3-0)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/hunyuanimage-3-0)
- [goose](https://spiral.ai/integrations/goose/hunyuanimage-3-0)
- [Grok](https://spiral.ai/integrations/grok/hunyuanimage-3-0)
- [Grok Build](https://spiral.ai/integrations/grok-build/hunyuanimage-3-0)
- [Hermes](https://spiral.ai/integrations/hermes/hunyuanimage-3-0)
- [Manus](https://spiral.ai/integrations/manus/hunyuanimage-3-0)
- [Muse](https://spiral.ai/integrations/muse/hunyuanimage-3-0)
- [Muse Code](https://spiral.ai/integrations/muse-code/hunyuanimage-3-0)
- [n8n](https://spiral.ai/integrations/n8n/hunyuanimage-3-0)
- [Notion](https://spiral.ai/integrations/notion/hunyuanimage-3-0)
- [OpenClaw](https://spiral.ai/integrations/openclaw/hunyuanimage-3-0)
- [opencode](https://spiral.ai/integrations/opencode/hunyuanimage-3-0)
- [Perplexity](https://spiral.ai/integrations/perplexity/hunyuanimage-3-0)
- [Raycast](https://spiral.ai/integrations/raycast/hunyuanimage-3-0)
- [VS Code](https://spiral.ai/integrations/vscode/hunyuanimage-3-0)
- [Windsurf](https://spiral.ai/integrations/windsurf/hunyuanimage-3-0)
- [Zapier](https://spiral.ai/integrations/zapier/hunyuanimage-3-0)

## More Instinct guides

- [HunyuanImage 2.1](https://spiral.ai/integrations/instinct/hunyuanimage-2-1)
- [Ideogram 2.0](https://spiral.ai/integrations/instinct/ideogram-2-0)
- [HiDream O1 Image Edit](https://spiral.ai/integrations/instinct/hidream-o1-image-edit)
- [Ideogram 2.0 Edit](https://spiral.ai/integrations/instinct/ideogram-2-0-edit)
- [HiDream O1 Image Dev Edit](https://spiral.ai/integrations/instinct/hidream-o1-image-dev-edit)
- [Ideogram 2.0 Remix](https://spiral.ai/integrations/instinct/ideogram-2-0-remix)

## Questions about HunyuanImage 3.0 in Instinct

**Can Instinct use HunyuanImage 3.0?**

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

**How much does HunyuanImage 3.0 cost in Instinct?**

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

**Do I need a fal account to use HunyuanImage 3.0 in Instinct?**

You need no fal account. Instinct uses one Spiral API key for every tool, and Spiral runs HunyuanImage 3.0 on its own fal account.

**How long does it take to set up HunyuanImage 3.0 in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while HunyuanImage 3.0 runs?**

HunyuanImage 3.0 runs in the background. Instinct 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.

