图片生成

开始

从GUI开始

参考 生成3D模型 的开始部分。

从CLI开始

使用 generate_image 工具启动图片生成任务。提交后立即返回 task_id 和 placeholder_path（占位纹理），调用 place_assets_in_scene 将占位纹理放入场景。生成完成后，真实图片会自动替换占位文件。

输入模式：

模式	参数	说明
文生图	prompt	纯文字描述
图生图	prompt + image_path	参考图 + 文字指导

⚠️ prompt 参数始终必填，即使提供了参考图。

异步流程：

1. 调用 generate_image → 返回 task_id + 占位纹理路径
2. 调用 place_assets_in_scene → 占位纹理立即出现在场景
3. 结束当前回合，等待 <bg_task_done> 通知自动到达
4. 收到通知后，占位纹理被真实图片自动替换

---

模型

火山 SeeDream Image（默认模型）

• 适用场景： 概念图、参考图、UI 背景、海报、横幅等通用图片
• 输出： PNG 导入为 Texture2D（Default 类型）
• 尺寸： 12 种预设尺寸，默认 2048×2048
• 背景分割： is_segmentation: true 自动去除背景
• 关键参数：
  • prompt（必填）：图片描述
  • image_path：参考图路径
  • size_id：输出尺寸 ID
  • is_segmentation：是否自动去除背景

Frontier（风格化效果模型）

• 适用场景： 风格化特效、艺术化图片
• 输出格式： PNG / JPEG
• 分辨率： 0.5K / 1K / 2K / 4K
• 宽高比： 16:9 / 9:16 / 1:1 等
• 关键参数：
  • prompt（必填）：图片描述
  • image_path：参考图路径
  • resolution：输出分辨率
  • aspect_ratio：宽高比
  • output_format：png / jpeg

模型选择决策

场景	选择
通用图片/概念图/UI 背景	SeeDream（默认）
需要自动背景去除	SeeDream + is_segmentation: true
风格化艺术效果	Frontier
需要特定宽高比	Frontier（支持 16:9 等）

---

优化

提示词优化

• 具体描述场景和元素："a fantasy castle on a cliff overlooking a stormy sea, dramatic lighting" > "a castle"
• 指定画面风格："oil painting style" / "photorealistic" / "anime style"
• SeeDream 支持中文提示词，但英文通常效果更稳定

尺寸与分辨率

• SeeDream 最小尺寸约 1920×1920，低于此可能返回 400 错误
• Frontier 低分辨率（0.5K/1K） 适合快速预览，2K/4K 适合最终产出
• 选择合适宽高比避免裁剪：UI 横幅用 16:9，图标用 1:1

背景分割

• 需要透明背景的精灵（游戏图标/道具图）→ 使用 generate_sprite 而非 generate_image
• generate_image 的 is_segmentation 适合概念图去背景，但产出类型是 Texture2D 而非 Sprite

并行生成

• 最大 5 个并发任务

---

注意事项

• ⚠️ prompt 始终必填，即使提供了 image_path
• ⚠️ 最小尺寸约 1920×1920（SeeDream），请求更小尺寸可能触发 400 错误
• ⚠️ Image ≠ Sprite：Image 产出为 Texture2D，适合概念图/背景/海报；Sprite 产出为 Sprite 类型，适合游戏图标/道具——需求不同请选对应工具
• ⚠️ 生成耗时 30–90 秒，工具调用立即返回，禁止轮询
• ⚠️ 输出路径：默认 Assets/TJGenerators/History/
• ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件