imagencn

name	imagenCN
description	Use when generating images with Alibaba Cloud Bailian API, especially for Chinese text rendering or photorealistic images
author	Agents365-ai
created	"2024-12-01T00:00:00.000Z"
updated	"2026-07-05T00:00:00.000Z"
homepage	https://github.com/Agents365-ai/imagenCN
metadata	{"openclaw":{"requires":{"bins":["python3"],"env":["DASHSCOPE_API_KEY"]},"primaryEnv":"DASHSCOPE_API_KEY","emoji":"🎨"}}

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

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

# 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

# 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

# With negative prompt
python ~/.claude/skills/imagenCN/scripts/generate_image.py --negative "blurry, low quality" "High quality portrait" portrait.png

# List all models
python ~/.claude/skills/imagenCN/scripts/generate_image.py --list-models

Requirements

pip install dashscope requests

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

Environment Variables

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

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

All keys are optional. Priority (highest first):

1. CLI arguments (--platform, --model, --size)
2. Project config (.imagenCN.json in current directory)
3. User config (~/.imagenCN.json)
4. Environment variables (DASHSCOPE_MODEL, ARK_MODEL, HUNYUAN_MODEL)
5. 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

# 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

Comparison with Imagen (Gemini)

Feature	ImagenCN (Bailian)	Imagen (Gemini)
Chinese text rendering	Excellent	Good
English text rendering	Excellent	Good
Photorealistic images	Excellent	Good
Speed	Medium	Fast
Model variety	15+ models	3 models
Max resolution	4K (Wan2.7-Pro)	2K

Examples

Volcano Ark (ByteDance)

# 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

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

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)

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

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