2D 模型生成

开始

从GUI开始

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

从CLI开始

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

输入模式：

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

异步流程：

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

---

常用模型

火山 SeeDream（唯一模型）

• 适用场景： 游戏图标、道具图片、角色头像、技能图标、UI 元素
• 输出： PNG 导入为 Sprite（Texture2D）
• 内容类型（content_type_id）： 31 种可选（武器、防具、消耗品、UI、技能、角色等）
• 美术风格（art_style_id）： 28 种可选（像素风、动漫、卡通、写实、奇幻等）
• 输出尺寸： 8 种预设尺寸，从 2048×2048 到 3024×1296
• 背景分割： is_segmentation: true 自动去除背景
• 关键参数：
  • prompt：精灵描述（必填，即使提供了参考图）
  • image_path：参考图路径
  • content_type_id：内容类型 ID
  • art_style_id：美术风格 ID
  • size_id：输出尺寸 ID
  • is_segmentation：是否自动去除背景

---

优化

提示词优化

• 结合内容类型和美术风格：选择合适的 content_type_id + art_style_id 比纯文字描述更能引导 AI 方向
• 具体描述道具特征："a glowing blue crystal sword with intricate rune engravings" > "a sword"

尺寸与精度

• 最小尺寸约 1920×1920，低于此可能返回 400 错误
• 常用 2048×2048，平衡质量与文件体积
• 需要 API 自动背景去除时，启用 is_segmentation: true

精灵缩放

• 默认 2048px / 100 PPU 的缩放比例 = 20.48 单位宽
• 放入场景时必须显式设置 localScale：0.05f ≈ 1 单位宽，0.10f ≈ 2 单位宽
• 不设置缩放会导致精灵在场景中异常巨大

并行生成

• 最大 5 个并发任务，可同时提交多个精灵生成请求

---

注意事项

• ⚠️ prompt 参数始终必填，即使提供了 image_path 也需要文字描述
• ⚠️ 最小尺寸约 1920×1920，请求更小尺寸可能触发 400 错误
• ⚠️ 精灵默认缩放异常巨大（2048px/100PPU = 20.48 单位），必须设置 localScale
• ⚠️ 生成耗时 60–180 秒，工具调用立即返回，禁止轮询，等待 <bg_task_done> 通知
• ⚠️ Sprite 与 Image 的区别：Sprite 用于游戏内 2D 素材（透明背景、图标、头像），Image 用于概念图、背景图等非精灵用途
• ⚠️ 输出路径：默认 Assets/TJGenerators/History/
• ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件