Keplerjai Image Gen

通过 ThinkZone AI 生成图片。当用户说「画图」「生图」「生成图片」「AI 绘图」「做一张图」「图生图」等时使用。支持 3 个图片模型（Gemini/MiniMax/Seedream）。

Install

openclaw skills install keplerjai-image-gen

ThinkZone Image Generation

使用 ThinkZone AI 平台的 3 个指定模型生成图片。

⚠️ 调用流程（必读）

当用户未指定模型时，必须先反问用户要用哪个模型，再执行生成。可这样询问：

请问要用哪个模型？

图片：Gemini（多模态/参考图）、MiniMax Image 01（人物主体参考）、Seedream（轻量 2K/3K）

用户明确指定模型后，再调用对应脚本。

当用户已指定模型（如「用 Gemini 画」「MiniMax 生成」）时，直接执行，无需反问。

🎨 支持的模型（3 个）

图片生成模型（3 个）

模型	Model ID	说明	尺寸/分辨率
Gemini 3.1 Flash Image Preview	`gemini-3.1-flash-image-preview`	Google 多模态图像生成	0.5K, 1K, 2K, 4K
MiniMax Image 01	`image-01`	MiniMax 图片生成	自定义 512-2048px
BytePlus Seedream 5.0 Lite	`doubao-seedream-5-0-260128`	BytePlus 轻量版	2K, 3K

🔧 配置

需要设置环境变量：

THINKZONE_API_KEY - API 密钥
THINKZONE_BASE_URL - API 基础 URL（可选，默认 https://open.thinkzoneai.com）

📸 图片生成使用

Gemini 3.1 Flash Image Preview

# 基本用法
python3 {baseDir}/scripts/gen_image.py \
  --prompt "一只穿宇航服的虾" \
  --model "gemini-3.1-flash-image-preview"

# 指定分辨率和宽高比
python3 {baseDir}/scripts/gen_image.py \
  --prompt "科幻城市夜景" \
  --model "gemini-3.1-flash-image-preview" \
  --resolution "2K" \
  --aspect-ratio "16:9"

# 带参考图（支持多张，最多 10 张）
python3 {baseDir}/scripts/gen_image.py \
  --prompt "基于参考图生成" \
  --model "gemini-3.1-flash-image-preview" \
  --images "path/to/image1.jpg" "path/to/image2.jpg" \
  --resolution "1K"

参数说明：

参数	说明	默认值	可选值
`--prompt`	图像描述文本	必填	-
`--model`	模型名称	`gemini-3.1-flash-image-preview`	固定
`--resolution`	分辨率	`1K`	`0.5K`, `1K`, `2K`, `4K`
`--aspect-ratio`	宽高比	`1:1`	`1:1`, `16:9`, `9:16`, `3:2`, `2:3`, `3:4`, `4:3`, `4:5`, `5:4`, `21:9`, `1:4`, `4:1`, `1:8`, `8:1`
`--images`	参考图路径（最多 10 张）	-	图片路径
`--thinking-level`	思考等级	`minimal`	`minimal`, `high`
`--output-dir`	输出目录	`./tmp/thinkzone-image`	路径

MiniMax Image 01

# 基本用法
python3 {baseDir}/scripts/gen_image.py \
  --prompt "一只可爱的猫咪" \
  --model "image-01"

# 指定宽高和数量
python3 {baseDir}/scripts/gen_image.py \
  --prompt "赛博朋克角色" \
  --model "image-01" \
  --width 1024 \
  --height 1024 \
  --n 4

# 图生图（人物主体参考）
python3 {baseDir}/scripts/gen_image.py \
  --prompt "穿古装的女性角色" \
  --model "image-01" \
  --subject-reference "path/to/character.jpg" \
  --aspect-ratio "3:4" \
  --watermark

参数说明：

参数	说明	默认值	可选值
`--prompt`	图像描述文本	必填	-
`--model`	模型名称	`image-01`	固定
`--width`	宽度像素	`1024`	512-2048（8 的倍数）
`--height`	高度像素	`1024`	512-2048（8 的倍数）
`--aspect-ratio`	宽高比	`1:1`	`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `2:3`, `3:2`
`--n`	生成数量	`1`	1-9
`--subject-reference`	人物主体参考图	-	图片路径
`--watermark`	是否添加水印	`false`	`true`, `false`

BytePlus Seedream 5.0 Lite

# 基本用法
python3 {baseDir}/scripts/gen_image.py \
  --prompt "中国风山水画" \
  --model "doubao-seedream-5-0-260128"

# 指定尺寸和格式
python3 {baseDir}/scripts/gen_image.py \
  --prompt "高质量产品渲染图" \
  --model "doubao-seedream-5-0-260128" \
  --size "3K" \
  --output-format "png"

# 批量生成（最多 15 张）+ 参考图（最多 14 张）
python3 {baseDir}/scripts/gen_image.py \
  --prompt "基于参考图变体" \
  --model "doubao-seedream-5-0-260128" \
  --images "ref1.jpg" "ref2.jpg" \
  --size "2K" \
  --max-images 4 \
  --no-watermark

参数说明：

参数	说明	默认值	可选值
`--prompt`	图像描述文本	必填	-
`--model`	模型名称	`seedream-5-0-260128`	固定
`--size`	输出尺寸	`2K`	`2K`, `3K`
`--output-format`	输出格式	`jpeg`	`jpeg`, `png`
`--max-images`	最大生成数量	`1`	1-15
`--images`	参考图路径（最多 14 张）	-	图片路径
`--watermark`	是否添加水印	`false`	`true`, `false`
`--stream`	流式输出	`false`	`true`, `false`

📋 前端调用参考（Vue 3）

参考 campus-amags/tenant/src/views/workbench 组件的调用方式：

图片生成调用示例

import { 
  postImageGeneration,      // MiniMax Image 01
  postV3ImageGenerations,   // BytePlus Seedream
  postGeminiGenerateContent // Gemini 3.1 Flash
} from './api/image'

// MiniMax Image 01
const minimaxPayload = {
  model: 'image-01',
  prompt: '你的提示词',
  width: 1024,
  height: 1024,
  aspect_ratio: '1:1',
  n: 1,
  aigc_watermark: false,
  subject_reference: [{ type: 'character', image_file: 'base64_or_url' }]
}
const result = await postImageGeneration(minimaxPayload)

// BytePlus Seedream 5.0 Lite
const seedreamPayload = {
  model: 'doubao-seedream-5-0-260128',
  prompt: '你的提示词',
  size: '2K',
  output_format: 'jpeg',
  watermark: false,
  image: ['url1', 'url2'],  // 参考图
  sequential_image_generation: 'auto',
  sequential_image_generation_options: { max_images: 4 }
}
const result = await postV3ImageGenerations(seedreamPayload)

// Gemini 3.1 Flash Image Preview
const geminiPayload = {
  contents: [
    { parts: [{ text: '你的提示词' }] },
    { parts: selectedImages.map(img => ({ inlineData: { mimeType: 'image/jpeg', data: img.base64 } })) }
  ],
  generationConfig: {
    responseModalities: ['IMAGE'],
    imageConfig: {
      aspectRatio: '16:9',
      imageSize: '2K'
    },
    thinkingConfig: {
      thinkingLevel: 'minimal',
      includeThoughts: false
    }
  }
}
const result = await postGeminiGenerateContent(geminiPayload)

⚠️ 注意事项

账户余额：确保 ThinkZone AI 账户有足够余额
图片尺寸限制：
- Gemini：分辨率 0.5K/1K/2K/4K
- MiniMax：512-2048px（8 的倍数）
- Seedream：2K/3K
参考图限制：
- Gemini：最多 10 张
- MiniMax：1 张（人物主体）
- Seedream：最多 14 张
超时处理：图片生成建议预留约 120 秒

🔗 相关链接

ThinkZone AI 平台：https://open.thinkzoneai.com
前端参考实现：C:\Users\Linsihuan\Desktop\campus-amags\tenant\src\views\workbench

最后更新：2026-04-17