tuzi-image-gen by tuziapi/tuzi-skills
npx skills add https://github.com/tuziapi/tuzi-skills --skill tuzi-image-gen多供应商图像生成。默认供应商:Tuzi (兔子API, api.tu-zi.com)。
代理执行 :
SKILL_DIR = 此 SKILL.md 文件所在目录${SKILL_DIR}/scripts/main.ts关键 : 此步骤必须在任何图像生成之前完成。请勿跳过或延迟。
检查所选供应商的 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 开发者,精准高效
关键 : 如果缺少 API 密钥,必须在任何生成之前引导用户获取并存储它。在密钥配置完成之前,生成将被阻塞。
检查 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 | |
--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):
image 字段中的 base64 数据 URLinput_reference| 变量 | 描述 |
|---|---|
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
优先级 (最高 → 最低),所有供应商:
--model <id>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| 预设 | Tuzi | OpenAI | |
|---|---|---|---|
normal | 1k | 1K | 1024px |
2k (默认) | 2k | 2K | 2048px |
--imageSize 1K|2K|4K 会覆盖 Tuzi 和 Google 的质量设置。
默认 : 顺序生成 (一次一个)。
并行 : 仅当用户明确请求时。使用 Task 工具并设置 run_in_background=true,推荐 4 个子代理 (最多 8 个)。
PROHIBITED_CONTENT → 内容拒绝错误NO_IMAGE → 提示过于模糊,建议更明确的提示格式: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。
每周安装次数
86
仓库
GitHub 星标数
24
首次出现
2026年3月5日
安全审计
安装于
openclaw65
opencode57
gemini-cli57
github-copilot57
amp57
cline57
AI Elements:基于shadcn/ui的AI原生应用组件库,快速构建对话界面
69,600 周安装
中国A股实时股票价格查询工具 - Python脚本,支持多股查询与默认指数
208 周安装
Kernel TypeScript SDK:浏览器自动化与Playwright远程执行开发工具
207 周安装
SwiftUI自适应布局指南:ViewThatFits、AnyLayout、Layout协议响应式设计
203 周安装
Excel财务模型自动化处理工具:零错误公式、标准格式与智能分析
205 周安装
Python日志记录最佳实践:Loguru配置、JSONL结构化日志与跨平台日志轮转指南
207 周安装
Vue 2 开发指南 - Options API、组件、Vuex、Vue Router 完整教程
207 周安装