[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [HunyuanImage 2.1](https://spiral.ai/integrations/instinct/hunyuanimage-2-1)

# How to Use HunyuanImage 2.1 in Instinct

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.

|  |  |
| --- | --- |
| Model | HunyuanImage 2.1 |
| 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 2.1 in Instinct

- Every Monday, use HunyuanImage 2.1 to illustrate the weekly newsletter topic at 2048 × 2048. Choose one concrete visual metaphor, use teal and rust, and leave the top quarter clear for a heading.
- Each morning, use HunyuanImage 2.1 to create a 2048 × 2048 illustration for the day's gardening tip: one clearly described plant, the relevant tool, natural light, and a simple background.
- Every Friday, use HunyuanImage 2.1 to make a 2560 × 1536 photographic concept from the weekly campaign brief. State the subject, setting, materials, and lighting explicitly; enable refinement.
- Each month, use HunyuanImage 2.1 to draft square artwork for the book club's announced theme at 2048 × 2048. Use a symbolic still life and reserve an empty area for the title.
- Every Wednesday, use HunyuanImage 2.1 to turn the week's Chinese-language cultural brief into a detailed Chinese illustration prompt. Generate 2048 × 2048 artwork and retain the prompt for review.

## How to set up HunyuanImage 2.1 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 2.1**: 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/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: Instinct finds HunyuanImage 2.1 on Spiral, shows the price and runs it.

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

## HunyuanImage 2.1 tools and prices

- [Hunyuan Image](https://spiral.ai/tools/fal/fal-ai/hunyuan-image/v2.1/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 | 3.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 2.1 in Instinct?

Prepare recurring editorial artwork from each day's or week's written brief with HunyuanImage 2.1. Keep the palette and composition instructions explicit in every run, and collect the results for review.

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

## Overview

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

## HunyuanImage 2.1 in other agents

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

## More Instinct guides

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

## Questions about HunyuanImage 2.1 in Instinct

**Can Instinct use HunyuanImage 2.1?**

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

**How much does HunyuanImage 2.1 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 2.1 in Instinct?**

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

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

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

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

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

