tuzi-image-gen：多供应商AI图像生成工具，支持Tuzi/Google/OpenAI等API

tuzi-image-gen by tuziapi/tuzi-skills

113 周安装量

27 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/tuziapi/tuzi-skills --skill tuzi-image-gen

AI/机器学习自动化图像处理

🇨🇳中文介绍

图像生成 (AI SDK)

多供应商图像生成。默认供应商：Tuzi (兔子API, api.tu-zi.com)。

脚本目录

代理执行 :

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

步骤 0：加载首选项 ⛔ 阻塞

关键 : 此步骤必须在任何图像生成之前完成。请勿跳过或延迟。

0.1 检查 API 密钥

检查所选供应商的 API 密钥是否可用。对于 Tuzi (默认)：

# 检查 env，然后是 .tuzi-skills/.env 文件
echo "${TUZI_API_KEY:-not_set}"
grep -s TUZI_API_KEY .tuzi-skills/.env "$HOME/.tuzi-skills/.env"

结果	操作
找到密钥	继续步骤 0.2
未找到密钥	⛔ 运行 API 密钥设置 (参见 references/config/first-time-setup.md → "API Key Setup") → 存储密钥 → 然后继续

广告位招租

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

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

联系我们

0.2 检查 EXTEND.md

检查 EXTEND.md 是否存在 (优先级：项目 → 用户)：

test -f .tuzi-skills/tuzi-image-gen/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-image-gen/EXTEND.md" && echo "user"

结果	操作
找到	加载、解析、应用设置。如果 `default_model.[provider]` 为 null → 仅询问模型 (流程 2)
未找到	⛔ 运行首次设置 (references/config/first-time-setup.md) → 保存 EXTEND.md → 然后继续

关键 : 如果未找到，请在生成任何图像之前使用 AskUserQuestion 完成完整设置 (供应商 + 模型 + 质量 + 保存位置)。在创建 EXTEND.md 之前，生成将被阻塞。

路径	位置
`.tuzi-skills/tuzi-image-gen/EXTEND.md`	项目目录
`$HOME/.tuzi-skills/tuzi-image-gen/EXTEND.md`	用户主目录

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

模式：references/config/preferences-schema.md

# 基本用法 (默认使用 Tuzi 供应商)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png

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

# 指定质量 (Tuzi: 1k/2k/4k)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k

# 4K VIP 模型
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --model gemini-3-pro-image-preview-4k-vip

# 使用参考图像
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make it blue" --image out.png --ref source.png

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

# 异步模型 (自动轮询)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --model gemini-3-pro-image-preview-2k-async

# 其他供应商
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider google
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate

选项	描述
`--prompt <text>`, `-p`	提示文本
`--promptfiles <files...>`	从文件读取提示 (拼接)
`--image <path>`	输出图像路径 (必需)
`--provider tuzi	google
`--model <id>`, `-m`	模型 ID (完整列表见 Tuzi 模型部分)
`--ar <ratio>`	宽高比 (例如 `16:9`, `1:1`, `4:3`)。Tuzi 会转换为 `NxN` 格式
`--size <WxH>`	尺寸覆盖 (例如 `1024x1024`, `16x9`)
`--quality normal	2k`
`--imageSize 1K	2K
`--ref <files...>`	参考图像。Tuzi：JSON 体中的 base64。Google：多模态。OpenAI：编辑 API
`--n <count>`	图像数量
`--json`	JSON 输出

Tuzi API (api.tu-zi.com) 是默认供应商。模型在质量、速度和支持的参数上有所不同。

模型 ID	别名	质量	备注
`gemini-3-pro-image-preview`	nano-banana-pro	`--quality` 1k/2k/4k	默认。高质量，支持质量参数
`gemini-3.1-flash-image-preview`	nano-banana-2	`--quality` 1k/2k/4k	快速，支持扩展宽高比
`gemini-3-pro-image-preview-vip`	nano-banana-pro-vip	1k 内置	高质量，VIP
`gemini-3-pro-image-preview-2k-vip`	nano-banana-pro-2k-vip	2k 内置	高质量 2K，VIP
`gemini-3-pro-image-preview-4k-vip`	nano-banana-pro-4k-vip	4k 内置	高质量 4K，VIP
`gemini-2.5-flash-image-vip`	nano-banana-vip	1k 内置	最快，VIP

模型 ID	别名	备注
`gemini-3-pro-image-preview`	nano-banana-pro	`--quality` 1k/2k/4k
`gemini-2.5-flash-image`	nano-banana	快速
`gemini-3-pro-image-preview-hd`	nano-banana-pro-hd	HD 内置
`gemini-3-pro-image-preview-2k`	nano-banana-pro-2k	2K 内置
`gemini-3-pro-image-preview-4k`	nano-banana-pro-4k	4K 内置
`gpt-image-1.5`	—	尺寸：仅 1:1, 3:2, 2:3
`bfl-flux-2-pro`	flux-2-pro	Flux
`bfl-flux-2-max`	flux-2-max	Flux 最高质量
`flux-kontext-pro`	kontext-pro	多参考编辑
`flux-kontext-max`	kontext-max	多参考编辑 (最大)
`doubao-seedream-4-0-250828`	Seedream 4.0	2K/4K
`doubao-seedream-4-5-251128`	Seedream 4.5	2K/4K
`doubao-seedream-5-0-260128`	Seedream 5.0 lite	2K/3K

自动检测。脚本提交任务并轮询直到完成 (5秒间隔，最长30分钟)。

模型 ID	备注
`gemini-3-pro-image-preview-async`	1K 异步
`gemini-3-pro-image-preview-2k-async`	2K 异步
`gemini-3-pro-image-preview-4k-async`	4K 异步
`mj-imagine`	Midjourney，MJ 参数在提示中

质量 (--quality 或 --imageSize 1K|2K|4K):

适用于	值	备注
`gemini-3.1-flash-image-preview`	1k / 2k / 4k	默认模型，质量可调
`gemini-3-pro-image-preview`	1k / 2k / 4k	质量可调
`-2k-vip`, `-4k-vip`, `*-hd`	—	质量已内置于模型名称中，参数被忽略
其他模型	—	参数被忽略

宽高比 (--ar):

适用于	支持的宽高比
Gemini 模型 (默认)	1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9
`gemini-3.1-flash-image-preview`	上述 + 1:4, 4:1, 1:8, 8:1 (极端宽高比)
`gpt-image-1.5`	1:1, 3:2, 2:3
省略	模型自动决定

参考图像 (--ref):

同步模型：JSON image 字段中的 base64 数据 URL
异步模型：FormData 中的 input_reference
所有 Tuzi 模型都支持参考图像

变量	描述
`TUZI_API_KEY`	Tuzi API 密钥 (https://api.tu-zi.com)
`TUZI_IMAGE_MODEL`	Tuzi 默认模型 (默认：gemini-3-pro-image-preview)
`TUZI_BASE_URL`	自定义 Tuzi 端点 (默认：https://api.tu-zi.com/v1)
`GOOGLE_API_KEY`	Google API 密钥
`OPENAI_API_KEY`	OpenAI API 密钥
`DASHSCOPE_API_KEY`	DashScope API 密钥 (阿里云)
`REPLICATE_API_TOKEN`	Replicate API 令牌
`GOOGLE_IMAGE_MODEL`	Google 模型覆盖
`OPENAI_IMAGE_MODEL`	OpenAI 模型覆盖
`DASHSCOPE_IMAGE_MODEL`	DashScope 模型覆盖
`REPLICATE_IMAGE_MODEL`	Replicate 模型覆盖
`GOOGLE_BASE_URL`	自定义 Google 端点
`OPENAI_BASE_URL`	自定义 OpenAI 端点
`DASHSCOPE_BASE_URL`	自定义 DashScope 端点
`REPLICATE_BASE_URL`	自定义 Replicate 端点

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

优先级 (最高 → 最低)，所有供应商：

CLI：--model <id>
EXTEND.md：default_model.[provider]
环境变量：<PROVIDER>_IMAGE_MODEL
内置默认值

代理必须在每次生成前显示模型信息:

显示：Using [provider] / [model]
显示切换提示：Switch model: --model <id> | EXTEND.md default_model.[provider] | env <PROVIDER>_IMAGE_MODEL

指定了 --provider → 使用它
提供了 --ref 且未指定 --provider → Tuzi > Google > OpenAI > Replicate
只有一个 API 密钥可用 → 使用该供应商
多个可用 → Tuzi 优先

预设	Tuzi	Google	OpenAI
`normal`	1k	1K	1024px
`2k` (默认)	2k	2K	2048px

--imageSize 1K|2K|4K 会覆盖 Tuzi 和 Google 的质量设置。

默认 : 顺序生成 (一次一个)。

并行 : 仅当用户明确请求时。使用 Task 工具并设置 run_in_background=true，推荐 4 个子代理 (最多 8 个)。

缺少 API 密钥 → ⛔ 必须从步骤 0.1 运行 API 密钥设置 (引导用户访问 https://api.tu-zi.com/token，存储在 .tuzi-skills/.env 中)。除非用户明确选择了不同的供应商，否则不要建议 GOOGLE_API_KEY 或其他供应商的密钥。
生成失败 → 自动重试一次
Tuzi PROHIBITED_CONTENT → 内容拒绝错误
Tuzi NO_IMAGE → 提示过于模糊，建议更明确的提示
异步超时 → 30 分钟后报错
无效宽高比 → 警告，使用默认值继续

格式：owner/name 或 owner/name:version

npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider replicate --model google/nano-banana

通过 EXTEND.md 进行自定义配置。有关路径和支持的选项，请参见步骤 0。

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

69,600 周安装

tuzi-image-gen：多供应商AI图像生成工具，支持Tuzi/Google/OpenAI等API

🇨🇳中文介绍

图像生成 (AI SDK)

脚本目录

步骤 0：加载首选项 ⛔ 阻塞

0.1 检查 API 密钥

相关 Skills

0.2 检查 EXTEND.md

用法

选项

Tuzi 模型

推荐

更多模型

异步模型

模型特定参数

环境变量

模型解析

供应商选择

质量预设

生成模式

错误处理

Replicate 模型

扩展支持

最新 Skills