图片生成引擎
多 Provider 图片生成引擎,通过统一的 CLI 接口调用 9 种图片生成服务。
脚本路径
- 1.
{baseDir} = 本 SKILL.md 所在目录 - 脚本路径 = INLINECODE1
- 运行时:
bun 可用 → bun; 否则 INLINECODE4
步骤 0: 加载偏好 ⛔ 阻塞
检查 EXTEND.md:
CODEBLOCK0
⛔ 运行
首次配置 → 保存 → 继续 |
兼容读取: .baoyu-skills/baoyu-imagine/EXTEND.md(fallback)
使用方式
CODEBLOCK1
批量文件格式
CODEBLOCK2
选项
| 选项 | 描述 |
|---|
| INLINECODE6 , INLINECODE7 | 提示词文本 |
| INLINECODE8 |
从文件读取提示词(多文件拼接) |
|
--image <path> | 输出图片路径 |
|
--batchfile <path> | 批量任务 JSON 文件 |
|
--jobs <count> | 批量 worker 数量(默认自动,上限见配置) |
|
--provider <name> | 强制指定 Provider |
|
--model <id>,
-m | 模型 ID |
|
--ar <ratio> | 宽高比(如 16:9, 3:4) |
|
--size <WxH> | 尺寸(如 1024x1024) |
|
--quality normal\|2k | 质量预设(默认 2k) |
|
--imageSize 1K\|2K\|4K | 图片尺寸(Google/OpenRouter) |
|
--ref <files...> | 参考图 |
|
--n <count> | 生成数量 |
|
--json | JSON 输出 |
环境变量
| 变量 | 描述 |
|---|
| INLINECODE22 | OpenAI API 密钥 |
| INLINECODE23 |
Azure OpenAI API 密钥 |
|
AZURE_OPENAI_BASE_URL | Azure 资源端点 |
|
GOOGLE_API_KEY | Google API 密钥 |
|
OPENROUTER_API_KEY | OpenRouter API 密钥 |
|
DASHSCOPE_API_KEY | 通义万相 API 密钥 |
|
MINIMAX_API_KEY | MiniMax API 密钥 |
|
REPLICATE_API_TOKEN | Replicate API 令牌 |
|
JIMENG_ACCESS_KEY_ID | 即梦火山引擎 Access Key(API 模式) |
|
JIMENG_SECRET_ACCESS_KEY | 即梦火山引擎 Secret Key(API 模式) |
|
ARK_API_KEY | 豆包 Seedream ARK API 密钥 |
加载优先级: CLI 参数 > EXTEND.md > 环境变量 > .panda-skills/.env > INLINECODE34
即梦 Provider 无需设置环境变量——安装 dreamina CLI 并登录后即可使用。
Provider 选择
| Provider | 默认模型 | 参考图 |
|---|
| google | gemini-3-pro-image-preview | ✓ |
| openai |
gpt-image-1.5 | ✓ |
| azure | gpt-image-1.5 | ✓ |
| openrouter | gemini-3.1-flash-image-preview | ✓ |
| dashscope | qwen-image-2.0-pro | ✗ |
| minimax | image-01 | ✓ |
| jimeng | jimeng
t2iv40 | ✓(CLI) |
| seedream | doubao-seedream-5-0 | ✓ |
| replicate | google/nano-banana-pro | ✓ |
即梦双模式:
- - CLI 模式(优先):安装了 dreamina CLI → 自动使用,支持
--ref 参考图 - API 模式(fallback):设置了
JIMENG_ACCESS_KEY_ID → 使用火山引擎 HMAC 签名,不支持 INLINECODE37
安装 dreamina CLI:
CODEBLOCK3
自动选择逻辑:
- 1. 有
--ref 且无 --provider → 按 google > openai > azure > openrouter > replicate > seedream > minimax > jimeng 顺序 - 指定
--provider → 使用该 Provider - 仅一个 API Key(或 dreamina CLI)→ 使用对应 Provider
- 多个可用 → 使用第一个
质量预设
| 预设 | Google | OpenAI | 用途 |
|---|
| normal | 1K | 1024px | 快速预览 |
| 2k(默认) |
2K | 2048px | 封面、插画、信息图 |
错误处理
- - API Key 缺失 → 报错并提示设置
- 生成失败 → 自动重试最多 3 次
- 参考图 + 不支持的 Provider → 报错并提示替代方案
参考文档
EXTEND.md schema |
图片生成引擎
多Provider图片生成引擎,通过统一的CLI接口调用9种图片生成服务。
脚本路径
- 1. {baseDir} = 本SKILL.md所在目录
- 脚本路径 = {baseDir}/scripts/main.ts
- 运行时: bun可用 → bun; 否则 npx -y bun
步骤0: 加载偏好 ⛔ 阻塞
检查EXTEND.md:
bash
test -f .panda-skills/panda-imagine/EXTEND.md && echo project
test -f $HOME/.panda-skills/panda-imagine/EXTEND.md && echo user
⛔ 运行
首次配置 → 保存 → 继续 |
兼容读取: .baoyu-skills/baoyu-imagine/EXTEND.md(回退)
使用方式
bash
基本用法
${BUN_X} {baseDir}/scripts/main.ts --prompt 一只猫 --image cat.png
指定宽高比
${BUN_X} {baseDir}/scripts/main.ts --prompt 风景画 --image out.png --ar 16:9
高质量
${BUN_X} {baseDir}/scripts/main.ts --prompt 一只猫 --image out.png --quality 2k
从提示词文件生成
${BUN_X} {baseDir}/scripts/main.ts --promptfiles prompt.md --image out.png
参考图(Google, OpenAI, Azure, OpenRouter, Replicate, MiniMax, Seedream)
${BUN_X} {baseDir}/scripts/main.ts --prompt 改为蓝色 --image out.png --ref source.png
通义万相
${BUN_X} {baseDir}/scripts/main.ts --prompt 一只可爱的猫 --image out.png --provider dashscope
MiniMax(角色参考图)
${BUN_X} {baseDir}/scripts/main.ts --prompt 站在窗前 --image out.jpg --provider minimax --ref portrait.png
即梦(自动检测dreamina CLI或API模式)
${BUN_X} {baseDir}/scripts/main.ts --prompt 科技海报 --image out.png --provider jimeng
即梦 + 参考图(需要dreamina CLI)
${BUN_X} {baseDir}/scripts/main.ts --prompt 改为水彩风格 --image out.png --provider jimeng --ref source.png
豆包Seedream
${BUN_X} {baseDir}/scripts/main.ts --prompt 一只猫 --image out.png --provider seedream
批量模式
${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json
批量文件格式
json
{
jobs: 4,
tasks: [
{
id: hero,
promptFiles: [prompts/hero.md],
image: out/hero.png,
ar: 16:9
}
]
}
选项
| 选项 | 描述 |
|---|
| --prompt <text>, -p | 提示词文本 |
| --promptfiles <files...> |
从文件读取提示词(多文件拼接) |
| --image
| 输出图片路径 |
| --batchfile | 批量任务JSON文件 |
| --jobs | 批量worker数量(默认自动,上限见配置) |
| --provider | 强制指定Provider |
| --model , -m | 模型ID |
| --ar | 宽高比(如16:9, 3:4) |
| --size | 尺寸(如1024x1024) |
| --quality normal\|2k | 质量预设(默认2k) |
| --imageSize 1K\|2K\|4K | 图片尺寸(Google/OpenRouter) |
| --ref | 参考图 |
| --n | 生成数量 |
| --json | JSON输出 |
环境变量
| 变量 | 描述 |
|---|
| OPENAIAPIKEY | OpenAI API密钥 |
| AZUREOPENAIAPI_KEY |
Azure OpenAI API密钥 |
| AZUREOPENAIBASE_URL | Azure资源端点 |
| GOOGLEAPIKEY | Google API密钥 |
| OPENROUTERAPIKEY | OpenRouter API密钥 |
| DASHSCOPEAPIKEY | 通义万相API密钥 |
| MINIMAXAPIKEY | MiniMax API密钥 |
| REPLICATEAPITOKEN | Replicate API令牌 |
| JIMENGACCESSKEY_ID | 即梦火山引擎Access Key(API模式) |
| JIMENGSECRETACCESS_KEY | 即梦火山引擎Secret Key(API模式) |
| ARKAPIKEY | 豆包Seedream ARK API密钥 |
加载优先级: CLI参数 > EXTEND.md > 环境变量 > .panda-skills/.env > ~/.panda-skills/.env
即梦Provider无需设置环境变量——安装dreamina CLI并登录后即可使用。
Provider选择
| Provider | 默认模型 | 参考图 |
|---|
| google | gemini-3-pro-image-preview | ✓ |
| openai |
gpt-image-1.5 | ✓ |
| azure | gpt-image-1.5 | ✓ |
| openrouter | gemini-3.1-flash-image-preview | ✓ |
| dashscope | qwen-image-2.0-pro | ✗ |
| minimax | image-01 | ✓ |
| jimeng | jimengt2iv40 | ✓(CLI) |
| seedream | doubao-seedream-5-0 | ✓ |
| replicate | google/nano-banana-pro | ✓ |
即梦双模式:
- - CLI模式(优先):安装了dreamina CLI → 自动使用,支持--ref参考图
- API模式(回退):设置了JIMENGACCESSKEYID → 使用火山引擎HMAC签名,不支持--ref
安装dreamina CLI:
bash
curl -fsSL https://jimeng.jianying.com/cli | bash
dreamina login
自动选择逻辑:
- 1. 有--ref且无--provider → 按google > openai > azure > openrouter > replicate > seedream > minimax > jimeng顺序
- 指定--provider → 使用该Provider
- 仅一个API Key(或dreamina CLI)→ 使用对应Provider
- 多个可用 → 使用第一个
质量预设
| 预设 | Google | OpenAI | 用途 |
|---|
| normal | 1K | 1024px | 快速预览 |
| 2k(默认) |
2K | 2048px | 封面、插画、信息图 |
错误处理
- - API Key缺失 → 报错并提示设置
- 生成失败 → 自动重试最多3次
- 参考图 + 不支持的Provider → 报错并提示替代方案
参考文档
EXTEND.md schema |