AI图像生成工具 - 支持OpenAI、Google、阿里通义万象多平台API调用

canghe-image-gen by freestylefly/canghe-skills

168 周安装量

182 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/freestylefly/canghe-skills --skill canghe-image-gen

AI/机器学习图像处理命令行工具

🇨🇳中文介绍

图像生成 (AI SDK)

基于官方 API 的图像生成。支持 OpenAI、Google、DashScope（阿里通义万象）和 Canghe 提供商。

脚本目录

代理执行：

SKILL_DIR = 此 SKILL.md 文件所在目录
脚本路径 = ${SKILL_DIR}/scripts/main.ts

偏好设置 (EXTEND.md)

使用 Bash 检查 EXTEND.md 是否存在（优先级顺序）：

# 首先检查项目级别
test -f .canghe-skills/canghe-image-gen/EXTEND.md && echo "project"

# 然后检查用户级别（跨平台：$HOME 在 macOS/Linux/WSL 上有效）
test -f "$HOME/.canghe-skills/canghe-image-gen/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ 路径 │ 位置 │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .canghe-skills/canghe-image-gen/EXTEND.md │ 项目目录 │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.canghe-skills/canghe-image-gen/EXTEND.md │ 用户主目录 │ └──────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ 结果 │ 操作 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 找到 │ 读取、解析、应用设置 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 未找到 │ 使用默认值 │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

827,200 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

111,800 周安装

AI Elements：基于shadcn/ui的AI原生应用组件库，快速构建对话界面

62,200 周安装

AI 代码实施计划编写技能 | 自动化开发任务分解与 TDD 流程规划工具

46,800 周安装

EXTEND.md 支持：默认提供商 | 默认质量 | 默认宽高比 | 默认图像尺寸 | 默认模型

架构：references/config/preferences-schema.md

# 基础用法
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只猫" --image cat.png

# 指定宽高比
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一幅风景画" --image out.png --ar 16:9

# 高质量
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只猫" --image out.png --quality 2k

# 从提示文件读取
npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png

# 使用参考图像（Google 多模态或 OpenAI 编辑）
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "变成蓝色" --image out.png --ref source.png

# 使用参考图像（显式指定提供商/模型）
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "变成蓝色" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png

# 指定提供商
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只猫" --image out.png --provider openai

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

# Canghe 第三方网关
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider canghe

选项	描述
`--prompt <text>`, `-p`	提示文本
`--promptfiles <files...>`	从文件读取提示（拼接）
`--image <path>`	输出图像路径（必需）
`--provider google	openai
`--model <id>`, `-m`	模型 ID（使用 `--ref` 时，OpenAI 需要 GPT Image 模型，例如 `gpt-image-1.5`）
`--ar <ratio>`	宽高比（例如 `16:9`、`1:1`、`4:3`）
`--size <WxH>`	尺寸（例如 `1024x1024`）
`--quality normal	2k`
`--imageSize 1K	2K
`--ref <files...>`	参考图像。支持 Google 多模态、OpenAI 编辑（GPT Image 模型）和 Canghe（`image_url`）。如果未指定提供商：优先 Google，然后 OpenAI，最后 Canghe
`--n <count>`	图像数量
`--json`	JSON 输出

变量	描述
`OPENAI_API_KEY`	OpenAI API 密钥
`GOOGLE_API_KEY`	Google API 密钥
`DASHSCOPE_API_KEY`	DashScope API 密钥（阿里云）
`CANGHE_API_KEY`	Canghe API 密钥
`OPENAI_IMAGE_MODEL`	OpenAI 模型覆盖
`GOOGLE_IMAGE_MODEL`	Google 模型覆盖
`DASHSCOPE_IMAGE_MODEL`	DashScope 模型覆盖（默认：z-image-turbo）
`CANGHE_IMAGE_MODEL`	Canghe 模型覆盖（默认：gemini-3-pro-image-preview）
`OPENAI_BASE_URL`	自定义 OpenAI 端点
`GOOGLE_BASE_URL`	自定义 Google 端点
`DASHSCOPE_BASE_URL`	自定义 DashScope 端点
`CANGHE_BASE_URL`	自定义 Canghe 端点（默认：`https://api.canghe.ai/v1`）

加载优先级：CLI 参数 > EXTEND.md > 环境变量 > <cwd>/.canghe-skills/.env > ~/.canghe-skills/.env

提供了 --ref + 未指定 --provider → 自动选择：优先 Google，然后 OpenAI，最后 Canghe
指定了 --provider → 使用它（如果使用 --ref，必须是 google 或 openai 或 canghe）
只有一个 API 密钥可用 → 使用该提供商
多个可用 → 默认为 Google

预设	Google imageSize	OpenAI 尺寸	使用场景
`normal`	1K	1024px	快速预览
`2k`（默认）	2K	2048px	封面、插图、信息图

Google imageSize：可通过 --imageSize 1K|2K|4K 覆盖

支持：1:1、16:9、9:16、4:3、3:4、2.35:1

Google 多模态：使用 imageConfig.aspectRatio
Google Imagen：使用 aspectRatio 参数
OpenAI：映射到最接近的受支持尺寸

默认：顺序生成（一次生成一张图像）。这确保了输出稳定且易于调试。

并行生成：仅当用户明确请求并行/并发生成时使用。

模式	何时使用
顺序（默认）	正常使用、单张图像、小批量
并行	用户明确请求、大批量（10+）

并行设置（当请求时）：

设置	值
推荐并发数	4 个子代理
最大并发数	8 个子代理
使用场景	用户请求并行时的大批量生成

代理实现（仅并行模式）：

# 使用 Task 工具并行启动多个生成
# 每个 Task 作为后台子代理运行，设置 run_in_background=true
# 所有任务完成后通过 TaskOutput 收集结果

缺少 API 密钥 → 错误并附带设置说明
生成失败 → 自动重试一次
无效宽高比 → 警告，使用默认值继续
参考图像与不支持的提供商/模型 → 错误并附带修复提示（切换到 Google 多模态或 OpenAI GPT Image 编辑）

通过 EXTEND.md 进行自定义配置。有关路径和支持的选项，请参阅偏好设置部分。

超能力技能使用指南：AI助手技能调用优先级与工作流程详解

46,500 周安装

AI图像生成工具 - 支持OpenAI、Google、阿里通义万象多平台API调用

🇨🇳中文介绍

图像生成 (AI SDK)

脚本目录

偏好设置 (EXTEND.md)

相关 Skills

用法

选项

环境变量

提供商选择

质量预设

宽高比

生成模式

错误处理

扩展支持

最新 Skills