imagenCN

Multi-platform AI image generation via DashScope/Ark/Hunyuan/Zhipu/StepFun, specializing in Chinese text rendering and photorealistic images

Agents365.ai@agents365-ai

Install

openclaw skills install @agents365-ai/imagencn

ImagenCN - Alibaba Cloud Bailian Text-to-Image Skill

Overview

Generate images using Alibaba Cloud Bailian API. Default endpoint is China region.

Supports five platforms across nine model families:

Alibaba Cloud Bailian (DashScope): Qwen-Image 2.0, Qwen-Image Edit, Qwen-Image legacy, Wan Series, Z-Image
ByteDance Volcano Ark: Doubao-Seedream series (OpenAI-compatible REST)
Tencent Hunyuan: Hunyuan Image 3.0 (OpenAI-compatible REST)
Zhipu / BigModel: CogView-4 and GLM-Image (OpenAI-compatible REST)
StepFun / 阶跃星辰: Step-2X and Step-Image-Edit (OpenAI-compatible REST)

Cross-platform support: Windows, macOS, Linux

When to Use This Skill

Automatically activate this skill when:

User requests image generation with Chinese text or calligraphy
Need photorealistic images or photography-style visuals
Creating commercial posters, illustrations, or digital art
User mentions any of these: Alibaba Cloud / Bailian / Qwen / Wan / DashScope, ByteDance / Volcano Ark / Seedream / Doubao, Tencent / Hunyuan
Any task where AI-generated image with strong Chinese support would be helpful

Model Reference

When the user wants to compare models, check pricing, or browse options before choosing, open the local model reference page in their browser:

bash

open ~/.claude/skills/imagenCN/docs/models.html

This page shows all 30 models across 5 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.

Workflow

Step 1 — Refine the prompt (interactive, never skip)

Users often give short, casual descriptions ("生成一只猫"). Before calling the API, present 3 refined prompt options with different style directions. Add, as appropriate:

Subject details (shape, colour, material, expression, pose)
Lighting (golden hour, studio, rim light, soft diffused, neon, cinematic)
Composition (rule of thirds, shallow depth of field, wide shot, close-up)
Style / medium (photorealistic, oil painting, watercolour, 3D render, vector)
Mood / atmosphere (serene, dramatic, whimsical, dystopian, elegant)
Quality keywords (8K, hyperdetailed, award-winning, professional photography)
For Chinese text on images: text content, placement, font style, colour, size

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.

Step 2 — Pick a model

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.

Step 3 — Pick a size

Native 2K for Qwen-Image 2.0, 1K/2K/4K for Wan2.7, or an aspect-ratio preset (16:9, 1:1, etc.).

Step 4 — Generate

Run scripts/generate_image.py with the confirmed prompt and output path.

Step 5 — Save

If the output path was implicit, save into the user's current working directory.

Models

Qwen-Image 2.0 family - Latest Flagship (MultiModalConversation API)

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

Qwen-Image Edit family - Image Editing (MultiModalConversation API)

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

Qwen-Image legacy (ImageSynthesis API)

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

Wan Series - Photorealistic Generation (ImageGeneration API)

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

Z-Image - Lightweight & Fast (MultiModalConversation API)

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

Volcano Ark - ByteDance Seedream (OpenAI-compatible API)

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

Tencent Hunyuan (OpenAI-compatible API)

Model	Description
`hy-image-v3.0`	Hunyuan default. Flagship 3.0, strong composition awareness, handles complex Chinese prompts up to 8K chars

Zhipu / BigModel - CogView-4 & GLM-Image (OpenAI-compatible API)

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

StepFun / 阶跃星辰 - Step-2X (OpenAI-compatible API)

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

Usage

Basic Usage

bash

# Default model (qwen-image-2.0-pro, native 2K output)
python ~/.claude/skills/imagenCN/scripts/generate_image.py "A cute cat" output.png

# Photorealistic with Wan model (Wan2.7 supports 4K)
python ~/.claude/skills/imagenCN/scripts/generate_image.py --model wan2.7-image-pro --size 4K "Realistic photo of mountains at sunset" photo.png

# Edit an existing image (requires --image; local path or URL)
python ~/.claude/skills/imagenCN/scripts/generate_image.py --model qwen-image-edit-max --image input.png "Change the background to a beach at sunset" edited.png

Size Options

bash

# 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

Size Presets

Qwen-Image 2.0 (native 2K):

1:1 -> 2048x2048 (default)
16:9 -> 2688x1536
9:16 -> 1536x2688
4:3 -> 2304x1728
3:4 -> 1728x2304
1K -> 1024x1024
2K -> 2048x2048

Qwen-Image legacy:

1:1 -> 1328x1328
16:9 -> 1664x928
9:16 -> 928x1664
4:3 -> 1472x1104
3:4 -> 1104x1472

Z-Image (pixel area 512x512 to 2048x2048):

1:1 -> 1024x1024 (default)
16:9 -> 1280x720
9:16 -> 720x1280
2:3 -> 1024x1536
3:2 -> 1536x1024
1K -> 1024x1024

Wan Series (Wan2.7 also accepts 1K/2K/4K):

1:1 -> 1024x1024
1:1-large -> 1280x1280
16:9 -> 1280x720
9:16 -> 720x1280
4:3 -> 1200x900
3:4 -> 900x1200
2:1 -> 1440x720

Volcano Ark (Seedream):

1:1 -> 2048x2048
16:9 -> 2848x1600
9:16 -> 1600x2848
4:3 -> 2304x1728
3:4 -> 1728x2304
3:2 -> 2496x1664
2:3 -> 1664x2496
1K / 2K / 3K / 4K (model-dependent max resolution)

Tencent Hunyuan (colon-separated format):

1:1 -> 1024:1024
16:9 -> 1920:1080
9:16 -> 1080:1920
4:3 -> 1600:1200
3:4 -> 1200:1600

Zhipu (CogView-4 / GLM-Image):

1:1 -> 1024x1024 (default)
16:9 -> 1344x768
9:16 -> 768x1344
4:3 -> 1152x864
3:4 -> 864x1152
2:1 -> 1440x720
1:2 -> 720x1440

StepFun (Step-2X):

1:1 -> 1024x1024 (default)
1:1-small -> 512x512
16:9 -> 1280x800
9:16 -> 800x1280

Advanced Options

bash

# 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

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

Requirements

bash

pip install dashscope requests

# Optional: for coloured output and styled tables
pip install rich

Environment Variables

bash

# 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

Get API Keys:

DashScope: https://bailian.console.aliyun.com/
Volcano Ark: https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
Tencent Hunyuan: https://console.cloud.tencent.com/tokenhub/apikey
Zhipu: https://bigmodel.cn
StepFun: https://platform.stepfun.com/interface-key

Config File (Optional)

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.

json

{
  "platform": "ark",
  "model": "doubao-seedream-5-0-260128",
  "size": "2K"
}

All keys are optional. Priority (highest first):

CLI arguments (--platform, --model, --size)
Project config (.imagenCN.json in current directory)
User config (~/.imagenCN.json)
Environment variables (DASHSCOPE_MODEL, ARK_MODEL, HUNYUAN_MODEL, ZHIPUAI_MODEL, STEP_MODEL)
Built-in defaults

API Endpoints

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`

bash

# Switch to Singapore endpoint
export DASHSCOPE_API_BASE="sg"

# Or use full URL
export DASHSCOPE_API_BASE="https://dashscope-intl.aliyuncs.com/api/v1"

Model Selection Guide

Quick Pick — You Only Need Eight

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

All other models are legacy/snapshot variants.

Full Reference

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`

Platform Quick Comparison

Feature	DashScope	Ark	Hunyuan	Zhipu	StepFun
Best for	Text, variety	Photo+text	Complex CN	CN text in image	Ultra-cheap
Max res	4K	4K	2K	2K	1K
SDK	`dashscope`	None	None	None	None
Price	Varies	~0.22	~0.20	~0.06	~0.02
Env var	`DASHSCOPE_API_KEY`	`ARK_API_KEY`	`HUNYUAN_API_KEY`	`ZHIPUAI_API_KEY`	`STEP_API_KEY`

Examples

Volcano Ark (ByteDance)

bash

# 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

Tencent Hunyuan

bash

# 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

Chinese New Year Poster (DashScope)

bash

python ~/.claude/skills/imagenCN/scripts/generate_image.py \
  "A beautiful Chinese New Year poster with red background, golden text, fireworks and firecrackers" \
  new_year_poster.png

Photorealistic Landscape (4K)

bash

python ~/.claude/skills/imagenCN/scripts/generate_image.py \
  --model wan2.7-image-pro \
  --size 4K \
  "Breathtaking sunset over mountain range, golden hour, professional photography" \
  landscape.png

Product Shot

bash

python ~/.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