Skip to content

Hunyuan ​

Mode: image · Models: 1

Vendor: Hunyuan (Tencent) · Official API docs: Fal — HunyuanImage v3

HunyuanImage v3 is Tencent's text-to-image model, hosted on Fal's serverless queue. It is strong at infographic-friendly generation with readable in-image text, and exposes CFG (guidance) control, a negative prompt, and small batch counts.

Models ​

idNameInput type
hunyuan-v3Hunyuan V3t2i

CLI ​

bash
# text-to-image, landscape
gen-ai generate -m hunyuan-v3 \
  -p "an infographic explaining the water cycle, clean readable labels" \
  --ar 16:9

# tighter prompt adherence with a higher CFG, batch of 2
gen-ai generate -m hunyuan-v3 \
  -p "a vintage travel poster of Kyoto in autumn" \
  --ar 3:4 --cfg 12 -n 2 --neg "blurry, text artifacts"

MCP ​

json
{ "name": "picsart_generate",
  "arguments": {
    "model": "hunyuan-v3",
    "prompt": "an infographic explaining the water cycle, clean readable labels",
    "aspectRatio": "16:9",
    "count": 1,
    "cfgScale": 7.5
  } }

Parameters ​

Full parameter surface for every model, sourced from gen-ai models info <id> --json. CLI flags show the primary short form; the canonical --kebab-case long form always works too.

hunyuan-v3 — Hunyuan V3 ​

Try hunyuan-v3 in Playground ↗

Input type: t2i

ParamCLI flagTypeValues
prompt-ptextrequired
aspectRatio--arenum1:1 · 16:9 · 9:16 · 4:3 · 3:4 (default 16:9)
count-nenum1 · 2 · 4 (default 1)
negativePrompt--negtextfree text
cfgScale--cfgnumber1–20, step 0.5, default 7.5

Notes: aspectRatio maps to Fal image_size, count→num_images (capped at 4), cfgScale→guidance_scale.

Pricing ​

bash
gen-ai pricing hunyuan-v3

Cost scales with count (number of images generated per call).

Built on @picsart/ai-sdk · gen-ai CLI · Picsart MCP · Media Studio · Skills