Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
freestylefly avatar

Canghe Image Gen

  • 562 installs
  • 424 repo stars
  • Updated June 8, 2026
  • freestylefly/canghe-skills

canghe-image-gen is a Claude Code skill that generates images on demand through OpenAI, Google, DashScope, and Canghe APIs using a bundled TypeScript script.

About

canghe-image-gen is an AI image generation skill from freestylefly/canghe-skills that runs `${SKILL_DIR}/scripts/main.ts` to call OpenAI, Google, DashScope (阿里通义万象), and Canghe providers for text-to-image and reference-image workflows with configurable aspect ratios. Sequential generation is the default, with parallel batches available on request, and project-level `.canghe` EXTEND.md preferences override defaults. Developers reach for canghe-image-gen when a coding agent must create, draw, or regenerate images inside a repository without switching to a separate design tool. Triggers include explicit image generation requests and reference-image edits during feature work.

  • Supports OpenAI, Google, DashScope, and Canghe image generation APIs
  • Handles text-to-image, reference images, and custom aspect ratios
  • Sequential generation by default with parallel mode available on request
  • Project and user-level EXTEND.md preference system for custom behavior
  • Runs via TypeScript script in the Canghe skills framework

Canghe Image Gen by the numbers

  • 562 all-time installs (skills.sh)
  • Ranked #385 of 1,337 Generative Media skills by installs in the Skillselion catalog
  • Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/freestylefly/canghe-skills --skill canghe-image-gen

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs562
repo stars424
Last updatedJune 8, 2026
Repositoryfreestylefly/canghe-skills

How do you generate images from a coding agent workflow?

Let their coding agent generate images on demand using multiple AI providers without leaving the workflow.

Who is it for?

Developers who need quick AI images inside Claude, Cursor, or Codex without opening a separate design application.

Skip if: Production brand systems requiring manual art direction, print-ready color management, or non-API local diffusion pipelines.

When should I use this skill?

A developer asks to generate, create, or draw images with AI providers during coding.

What you get

Generated image files, provider-selected renders, and optional parallel batch outputs saved to the project.

  • generated image files
  • reference-based renders

By the numbers

  • Supports 4 AI image API providers
  • Bundled TypeScript entry script at scripts/main.ts

Files

SKILL.mdMarkdownGitHub ↗

Image Generation (AI SDK)

Official API-based image generation. Supports OpenAI, Google, DashScope (阿里通义万象), and Canghe providers.

Script Directory

Agent Execution: 1. SKILL_DIR = this SKILL.md file's directory 2. Script path = ${SKILL_DIR}/scripts/main.ts

Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .canghe-skills/canghe-image-gen/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.canghe-skills/canghe-image-gen/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .canghe-skills/canghe-image-gen/EXTEND.md │ Project directory │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.canghe-skills/canghe-image-gen/EXTEND.md │ User home │ └──────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ Result │ Action │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Found │ Read, parse, apply settings │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Not found │ Use defaults │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md Supports: Default provider | Default quality | Default aspect ratio | Default image size | Default models

Schema: references/config/preferences-schema.md

Usage

# Basic
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png

# With aspect ratio
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9

# High quality
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k

# From prompt files
npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png

# With reference images (Google multimodal or OpenAI edits)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png

# With reference images (explicit provider/model)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png

# Specific provider
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai

# DashScope (阿里通义万象)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope

# Canghe third-party gateway
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider canghe

Options

OptionDescription
--prompt <text>, -pPrompt text
--promptfiles <files...>Read prompt from files (concatenated)
--image <path>Output image path (required)
`--provider google\openai\
--model <id>, -mModel ID (--ref with OpenAI requires GPT Image model, e.g. gpt-image-1.5)
--ar <ratio>Aspect ratio (e.g., 16:9, 1:1, 4:3)
--size <WxH>Size (e.g., 1024x1024)
`--quality normal\2k`
`--imageSize 1K\2K\
--ref <files...>Reference images. Supported by Google multimodal, OpenAI edits (GPT Image models), and Canghe (image_url). If provider omitted: Google first, then OpenAI, then Canghe
--n <count>Number of images
--jsonJSON output

Environment Variables

VariableDescription
OPENAI_API_KEYOpenAI API key
GOOGLE_API_KEYGoogle API key
DASHSCOPE_API_KEYDashScope API key (阿里云)
CANGHE_API_KEYCanghe API key
OPENAI_IMAGE_MODELOpenAI model override
GOOGLE_IMAGE_MODELGoogle model override
DASHSCOPE_IMAGE_MODELDashScope model override (default: z-image-turbo)
CANGHE_IMAGE_MODELCanghe model override (default: gemini-3-pro-image-preview)
OPENAI_BASE_URLCustom OpenAI endpoint
GOOGLE_BASE_URLCustom Google endpoint
DASHSCOPE_BASE_URLCustom DashScope endpoint
CANGHE_BASE_URLCustom Canghe endpoint (default: https://api.canghe.ai/v1)

Load Priority: CLI args > EXTEND.md > env vars > <cwd>/.canghe-skills/.env > ~/.canghe-skills/.env

Provider Selection

1. --ref provided + no --provider → auto-select Google first, then OpenAI, then Canghe 2. --provider specified → use it (if --ref, must be google or openai or canghe) 3. Only one API key available → use that provider 4. Multiple available → default to Google

Quality Presets

PresetGoogle imageSizeOpenAI SizeUse Case
normal1K1024pxQuick previews
2k (default)2K2048pxCovers, illustrations, infographics

Google imageSize: Can be overridden with --imageSize 1K|2K|4K

Aspect Ratios

Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 2.35:1

  • Google multimodal: uses imageConfig.aspectRatio
  • Google Imagen: uses aspectRatio parameter
  • OpenAI: maps to closest supported size

Generation Mode

Default: Sequential generation (one image at a time). This ensures stable output and easier debugging.

Parallel Generation: Only use when user explicitly requests parallel/concurrent generation.

ModeWhen to Use
Sequential (default)Normal usage, single images, small batches
ParallelUser explicitly requests, large batches (10+)

Parallel Settings (when requested):

SettingValue
Recommended concurrency4 subagents
Max concurrency8 subagents
Use caseLarge batch generation when user requests parallel

Agent Implementation (parallel mode only):

# Launch multiple generations in parallel using Task tool
# Each Task runs as background subagent with run_in_background=true
# Collect results via TaskOutput when all complete

Error Handling

  • Missing API key → error with setup instructions
  • Generation failure → auto-retry once
  • Invalid aspect ratio → warning, proceed with default
  • Reference images with unsupported provider/model → error with fix hint (switch to Google multimodal or OpenAI GPT Image edits)

Extension Support

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

Related skills

FAQ

Which image providers does canghe-image-gen support?

canghe-image-gen routes requests to four API providers: OpenAI, Google, DashScope (阿里通义万象), and Canghe. The skill's main.ts script handles text-to-image and reference-image calls with configurable aspect ratios.

How does canghe-image-gen run inside a project?

canghe-image-gen executes `${SKILL_DIR}/scripts/main.ts` from the skill directory. It checks project-level `.canghe` EXTEND.md for preferences and defaults to sequential generation unless parallel output is requested.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.