OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add agents365-ai/365-skills --skill imagencn
Multi-platform AI image generation via DashScope/Ark/Hunyuan/Zhipu/StepFun plus Grok/OpenAI/Gemini/FLUX (international), specializing in Chinese text rendering and photorealistic images
npx skills add agents365-ai/365-skills --skill imagencn
imagencn — Image Generation, Cloud-Native: one CLI, every image cloud. The project started with China-friendly clouds and now covers international providers as well.
Generate images using Alibaba Cloud Bailian API. Default endpoint is China region.
Supports nine platforms across fourteen model families:
Cross-platform support: Windows, macOS, Linux
Automatically activate this skill when:
When the user wants to compare models, check pricing, or browse options before choosing, open the local model reference page in their browser:
This page shows all 44 models across 9 platforms with pricing, resolution,
feature highlights, and a quick-reference guide. On Linux use xdg-open;
the file also works from file:// with no server needed.
Users often give short, casual descriptions ("生成一只猫"). Before calling the API, present 3 refined prompt options with different style directions. Add, as appropriate:
Label the options clearly (e.g. A / B / C) with a one-line summary of each direction. Let the user pick one, combine elements from multiple, or request a new direction. Iterate until they confirm ("go", "generate", "ok", etc.), then proceed to generation.
Choose based on the request (see Model Selection Guide below). Default to
qwen-image-2.0-pro if unsure. Mention your choice to the user.
Native 2K for Qwen-Image 2.0, 1K/2K/4K for Wan2.7, or an aspect-ratio
preset (16:9, 1:1, etc.).
Run scripts/generate_image.py with the confirmed prompt and output path.
If the output path was implicit, save into the user's current working directory.
| Model | Description |
|---|---|
qwen-image-2.0-pro | Default. Latest flagship, native 2K, strongest typography and detail |
qwen-image-2.0-pro-2026-06-22 | Latest snapshot (Jun 2026): generation + editing fusion, better text rendering and prompt adherence |
qwen-image-2.0 | Standard 2.0 tier, native 2K |
qwen-image-max | Previous-gen flagship (Dec 2025) |
qwen-image-max-2025-12-30 | qwen-image-max snapshot: improved realism, fewer AI artifacts |
Editing models require an input image via --image (local path or URL). Omit --size to match the input image dimensions.
| Model | Description |
|---|---|
qwen-image-edit-max | Flagship editing model, strongest instruction following |
qwen-image-edit-max-2026-01-16 | Latest max snapshot (Jan 2026) |
qwen-image-edit-plus | Faster, lower-cost editing |
| Model | Description |
|---|---|
qwen-image-plus | Distilled accelerated version of qwen-image-max |
qwen-image-plus-2026-01-09 | qwen-image-plus snapshot (Jan 2026): faster high-quality generation |
qwen-image | Base model |
| Model | Description |
|---|---|
wan2.7-image-pro | Latest. Up to 4K output, unified architecture (T2I + edit + multi-image) |
wan2.7-image | Wan 2.7 standard, up to 2K |
wan2.6-t2i | Wan 2.6, flexible sizing |
wan2.5-t2i-preview | High quality, up to 768x2700 |
wan2.2-t2i-flash | Speed-optimized |
wan2.2-t2i-plus | Professional tier |
wanx2.1-t2i-turbo | Fast execution |
wanx2.1-t2i-plus | Professional tier |
wanx2.0-t2i-turbo | Earlier generation |
| Model | Description |
|---|---|
z-image-turbo | Fast, low-cost generation; bilingual (CN/EN) text rendering, high-fidelity portraits and product images. Pixel area 512x512 to 2048x2048 |
| Model | Description |
|---|---|
doubao-seedream-5-0-260128 | Ark default. Latest, up to 3K, PNG/JPEG output, best text rendering |
doubao-seedream-4-5-251128 | Seedream 4.5, up to 4K |
doubao-seedream-4-0-250828 | Seedream 4.0, up to 4K, budget-friendly |
| Model | Description |
|---|---|
hy-image-v3.0 | Hunyuan default. Flagship 3.0, strong composition awareness, handles complex Chinese prompts up to 8K chars |
| Model | Description |
|---|---|
cogview-4 | Zhipu default. Stable alias for latest CogView-4, native Chinese text rendering |
cogview-4-250304 | CogView-4 fixed snapshot (Mar 2025), reproducible results |
glm-image | GLM-Image flagship, up to 2048x2048, hybrid autoregressive/diffusion |
| Model | Description |
|---|---|
step-2x-large | StepFun default. High quality (0.1 RMB/image), up to 1024x1024 |
step-image-edit-2 | Fast & cheap (0.02 RMB/image), supports negative prompts, 8 inference steps |
| Model | Description |
|---|---|
gemini-3-pro-image-preview | Gemini default. Google flagship image model, 512/1K/2K named sizes plus aspect-ratio presets |
gemini-3-pro-image | Stable flagship (Nano Banana Pro), 1K/2K/4K |
gemini-3.1-flash-image | Nano Banana 2: fast generalist, 512/1K/2K/4K, strong text rendering |
gemini-3.1-flash-lite-image | Nano Banana 2 Lite: fastest/cheapest, 1K only |
| Model | Description |
|---|---|
grok-imagine-image-quality | Grok default. High-quality Grok image model, aspect-ratio + resolution presets (up to 4K) |
grok-imagine-image | Standard Grok image model (alias grok-imagine-image-2026-03-02) |
grok-2-image | Legacy JPG model, no size control |
| Model | Description |
|---|---|
gpt-image-1 | OpenAI default. Multimodal image model; 1024x1024 / 1536x1024 / 1024x1536 only |
gpt-image-1-mini | Fast, cheap GPT image variant |
gpt-image-1.5 | Improved GPT image generation quality |
gpt-image-2 | Latest flagship; arbitrary WxH sizes (edges divisible by 16) up to 4K |
FLUX uses an asynchronous API: submit a request, poll for completion, then
save. Prompt upsampling is built in (disable with disable_pup when needed).
| Model | Description |
|---|---|
flux-2-pro-preview | FLUX default. Latest rolling FLUX.2 Pro, recommended for new use cases |
flux-2-pro | Fixed snapshot of FLUX.2 Pro for reproducible workflows |
flux-2-max | Highest quality FLUX.2, search-grounding for real-time information |
FLUX 3: image generation is not yet publicly available via API (early access only, no public endpoint as of Aug 2026). Watch
bfl.aifor the general release.
Qwen-Image 2.0 (native 2K):
1:1 -> 2048x2048 (default)16:9 -> 2688x15369:16 -> 1536x26884:3 -> 2304x17283:4 -> 1728x23041K -> 1024x10242K -> 2048x2048Qwen-Image legacy:
1:1 -> 1328x132816:9 -> 1664x9289:16 -> 928x16644:3 -> 1472x11043:4 -> 1104x1472Z-Image (pixel area 512x512 to 2048x2048):
1:1 -> 1024x1024 (default)16:9 -> 1280x7209:16 -> 720x12802:3 -> 1024x15363:2 -> 1536x10241K -> 1024x1024Wan Series (Wan2.7 also accepts 1K/2K/4K):
1:1 -> 1024x10241:1-large -> 1280x128016:9 -> 1280x7209:16 -> 720x12804:3 -> 1200x9003:4 -> 900x12002:1 -> 1440x720Volcano Ark (Seedream):
1:1 -> 2048x204816:9 -> 2848x16009:16 -> 1600x28484:3 -> 2304x17283:4 -> 1728x23043:2 -> 2496x16642:3 -> 1664x24961K / 2K / 3K / 4K (model-dependent max resolution)Tencent Hunyuan (colon-separated format):
1:1 -> 1024:102416:9 -> 1920:10809:16 -> 1080:19204:3 -> 1600:12003:4 -> 1200:1600Zhipu (CogView-4 / GLM-Image):
1:1 -> 1024x1024 (default)16:9 -> 1344x7689:16 -> 768x13444:3 -> 1152x8643:4 -> 864x11522:1 -> 1440x7201:2 -> 720x1440StepFun (Step-2X):
1:1 -> 1024x1024 (default)1:1-small -> 512x51216:9 -> 1280x8009:16 -> 800x1280Google Gemini (named sizes + aspect ratios):
512 / 1K (default) / 2K / 4K -> named output size (4K on Pro / 3.1 Flash; Lite is 1K only)1:1, 16:9, 9:16, 4:3, 3:4 -> aspect ratio (no exact pixel sizes)Grok / xAI (aspect ratio + resolution):
1:1, 16:9, 9:16, 4:3, 3:4, 2:1 -> sent as aspect_ratio (default: 1:1)1K / 2K / 4K -> sent as resolutionOpenAI (GPT Image):
1:1 -> 1024x1024 (default)16:9 -> 1536x1024, 9:16 -> 1024x15364:3 -> 1344x1024, 3:4 -> 1024x13441K -> 1024x1024, 2K -> 2048x2048 (gpt-image-2 only), 4K -> 3840x2160 (gpt-image-2 only)FLUX (Black Forest Labs):
1:1 -> 1024x1024 (default)16:9 -> 1344x768, 9:16 -> 768x13444:3 -> 1152x864, 3:4 -> 864x11522:1 -> 1440x720, 1:2 -> 720x14401K -> 1024x1024, 2K -> 2048x2048 (flexible WxH also accepted)Get API Keys:
Create ~/.imagencn.json for personal defaults, or .imagencn.json in a project
directory for per-project overrides. API keys stay in environment variables for
security.
All keys are optional. Priority (highest first):
--platform, --model, --size).imagencn.json in current directory)~/.imagencn.json)DASHSCOPE_MODEL, ARK_MODEL, HUNYUAN_MODEL, ZHIPUAI_MODEL, STEP_MODEL, GEMINI_MODEL, XAI_MODEL, OPENAI_MODEL, BFL_MODEL)| Region | Alias | URL |
|---|---|---|
| China (default) | cn | https://dashscope.aliyuncs.com/api/v1 |
| Singapore | sg | https://dashscope-intl.aliyuncs.com/api/v1 |
| Virginia | us | https://dashscope-us.aliyuncs.com/api/v1 |
| What you want | Model | Platform |
|---|---|---|
| Default / general (posters, text) | qwen-image-2.0-pro | DashScope |
| Photorealistic (portraits, landscapes) | wan2.7-image-pro | DashScope |
| Edit an image | qwen-image-edit-max | DashScope |
| Cheap & fast | z-image-turbo | DashScope |
| Photo + text combo | doubao-seedream-5-0-260128 | Volcano Ark |
| Complex Chinese composition | hy-image-v3.0 | Tencent Hunyuan |
| Chinese text in images | cogview-4 | Zhipu |
| Ultra-cheap volume gen | step-image-edit-2 | StepFun |
| International (non-China) | gemini-3-pro-image-preview | Google Gemini |
| International / Grok | grok-imagine-image-quality | Grok / xAI |
| International / OpenAI | gpt-image-1 | OpenAI |
| International / FLUX | flux-2-pro-preview | Black Forest Labs |
All other models are legacy/snapshot variants.
| Use Case | Recommended Model |
|---|---|
| General high-quality (default) | qwen-image-2.0-pro |
| Chinese text/calligraphy | qwen-image-2.0-pro |
| English text on images | qwen-image-2.0-pro |
| Posters with typography | qwen-image-2.0-pro |
| Photorealistic photos (4K) | wan2.7-image-pro |
| Photorealistic photos (2K) | wan2.7-image |
| Portrait photography | wan2.7-image-pro |
| Image editing (best quality) | qwen-image-edit-max |
| Image editing (fast, low-cost) | qwen-image-edit-plus |
| Fast, low-cost generation | z-image-turbo |
| High-fidelity portraits / product shots (fast) | z-image-turbo |
| Fast photorealistic (Wan) | wan2.2-t2i-flash |
| Lower-cost text rendering | qwen-image-plus |
| ByteDance best quality | doubao-seedream-5-0-260128 |
| Budget-friendly 4K (ByteDance) | doubao-seedream-4-0-250828 |
| Complex Chinese prompts (Tencent) | hy-image-v3.0 |
| Feature | DashScope | Ark | Hunyuan | Zhipu | StepFun | Gemini | Grok | OpenAI | FLUX |
|---|---|---|---|---|---|---|---|---|---|
| Best for | Text, variety | Photo+text | Complex CN | CN text in image | Ultra-cheap | International | International | International | International |
| Max res | 4K | 4K | 2K | 2K | 1K | 4K | 4K | 4K (gpt-image-2) | 2K |
| SDK | dashscope | None | None | None | None | None | None | None | None |
| Price | Varies | ~0.22 | ~0.20 | ~0.06 | ~0.02 | ~$0.13 | ~$0.14 | ~$0.04 | ~$0.03 |
| Env var | DASHSCOPE_API_KEY | ARK_API_KEY | HUNYUAN_API_KEY | ZHIPUAI_API_KEY | STEP_API_KEY | GEMINI_API_KEY | XAI_API_KEY | OPENAI_API_KEY | BFL_API_KEY |
# Use ratio preset
python ~/.claude/skills/imagencn/scripts/generate_image.py --size 16:9 "Wide landscape" landscape.png
# Use exact dimensions
python ~/.claude/skills/imagencn/scripts/generate_image.py --size 1280*720 "Custom size" custom.png# With negative prompt
python ~/.claude/skills/imagencn/scripts/generate_image.py --negative "blurry, low quality" "High quality portrait" portrait.png
# Disable automatic prompt extension (DashScope only)
python ~/.claude/skills/imagencn/scripts/generate_image.py --no-extend "A photorealistic cat" cat.png
# Set random seed for reproducibility
python ~/.claude/skills/imagencn/scripts/generate_image.py --seed 42 "A cat" cat.png
# Rendering quality (OpenAI only: low / medium / high / auto)
python ~/.claude/skills/imagencn/scripts/generate_image.py --platform openai --quality high "A cat" cat.png
# Guidance scale (Volcano Ark only)
python ~/.claude/skills/imagencn/scripts/generate_image.py --platform ark --guidance-scale 7.5 "Portrait" portrait.png
# Disable watermark (Volcano Ark only)
python ~/.claude/skills/imagencn/scripts/generate_image.py --platform ark --no-watermark "Artwork" art.png
# Auto-enhance prompt on/off (Tencent Hunyuan only, --revise 0=off 1=on)
python ~/.claude/skills/imagencn/scripts/generate_image.py --platform hunyuan --revise 0 "A cat" cat.png
# Add AI logo (Tencent Hunyuan only, --logo 0=no 1=yes)
python ~/.claude/skills/imagencn/scripts/generate_image.py --platform hunyuan --logo 1 "Poster" poster.png
# Dry run (preview without making API call)
python ~/.claude/skills/imagencn/scripts/generate_image.py --dry-run --platform ark "Test prompt"
# List all models
python ~/.claude/skills/imagencn/scripts/generate_image.py --list-modelspip install dashscope requests
# Optional: for coloured output and styled tables
pip install rich# Alibaba Cloud Bailian (DashScope)
export DASHSCOPE_API_KEY="your_api_key" # Required
export DASHSCOPE_MODEL="wan2.7-image-pro" # Optional default model
export DASHSCOPE_API_BASE="cn" # Optional: cn, sg, us
# ByteDance Volcano Ark
export ARK_API_KEY="your_api_key" # Required for Ark
export ARK_MODEL="doubao-seedream-5-0-260128" # Optional default model
# Tencent Hunyuan (TokenHub)
export HUNYUAN_API_KEY="your_api_key" # Required for Hunyuan
export HUNYUAN_MODEL="hy-image-v3.0" # Optional default model
# Zhipu / BigModel
export ZHIPUAI_API_KEY="your_api_key" # Required for Zhipu
export ZHIPUAI_MODEL="cogview-4" # Optional default model
# StepFun / 阶跃星辰
export STEP_API_KEY="your_api_key" # Required for StepFun
export STEP_MODEL="step-2x-large" # Optional default model
# Google Gemini (international)
export GEMINI_API_KEY="your_api_key" # Required for Gemini
export GEMINI_MODEL="gemini-3-pro-image-preview" # Optional default model
# Grok / xAI (international)
export XAI_API_KEY="your_api_key" # Required for Grok
export XAI_MODEL="grok-imagine-image-quality" # Optional default model
# OpenAI (international)
export OPENAI_API_KEY="your_api_key" # Required for OpenAI
export OPENAI_MODEL="gpt-image-1" # Optional default model
# Black Forest Labs / FLUX (international)
export BFL_API_KEY="your_api_key" # Required for FLUX
export BFL_MODEL="flux-2-pro-preview" # Optional default model{
"platform": "ark",
"model": "doubao-seedream-5-0-260128",
"size": "2K"
}# Switch to Singapore endpoint
export DASHSCOPE_API_BASE="sg"
# Or use full URL
export DASHSCOPE_API_BASE="https://dashscope-intl.aliyuncs.com/api/v1"# Default Ark model (Seedream 5.0)
ARK_API_KEY="xxx" python scripts/generate_image.py \
--platform ark \
"A vibrant close-up editorial portrait, Vogue magazine cover style" \
portrait.png
# With 4K output
ARK_API_KEY="xxx" python scripts/generate_image.py \
--platform ark --model doubao-seedream-4-5-251128 --size 4K \
"Breathtaking mountain sunset, golden hour, professional photography" \
landscape.png# Default Hunyuan model (Image 3.0)
HUNYUAN_API_KEY="xxx" python scripts/generate_image.py \
--platform hunyuan \
"An astronaut riding a horse on the moon, cinematic lighting, 8K detail" \
scifi.png
# With prompt auto-enhance disabled
HUNYUAN_API_KEY="xxx" python scripts/generate_image.py \
--platform hunyuan --revise 0 \
"A cute orange cat napping in sunlight, oil painting style" \
cat.png# Default Gemini model (Gemini 3 Pro Image)
GEMINI_API_KEY="xxx" python scripts/generate_image.py \
--platform gemini --size 2K \
"A serene Japanese garden with koi pond, soft morning light" \
garden.png# Default Grok model (Grok Imagine Image Quality)
XAI_API_KEY="xxx" python scripts/generate_image.py \
--platform grok --size 16:9 \
"A cinematic cyberpunk city street at night, neon reflections" \
city.png# Default OpenAI model (GPT Image 1), high quality
OPENAI_API_KEY="xxx" python scripts/generate_image.py \
--platform openai --quality high \
"Minimalist product shot of a ceramic teapot on linen, soft studio light" \
teapot.png# Default FLUX model (FLUX.2 Pro Preview); async API — polls until ready
BFL_API_KEY="xxx" python scripts/generate_image.py \
--platform bfl --size 16:9 \
"A dramatic volcanic coastline at dusk, long exposure photography" \
coast.png
# Pinned snapshot for reproducible results
BFL_API_KEY="xxx" python scripts/generate_image.py \
--platform bfl --model flux-2-pro --seed 42 \
"An astronaut walking through a bioluminescent jungle" \
jungle.pngpython ~/.claude/skills/imagencn/scripts/generate_image.py \
"A beautiful Chinese New Year poster with red background, golden text, fireworks and firecrackers" \
new_year_poster.pngpython ~/.claude/skills/imagencn/scripts/generate_image.py \
--model wan2.7-image-pro \
--size 4K \
"Breathtaking sunset over mountain range, golden hour, professional photography" \
landscape.pngpython ~/.claude/skills/imagencn/scripts/generate_image.py \
--model wan2.7-image \
--size 2K \
"Professional product photography of a coffee cup on marble surface, studio lighting" \
product.png