使用图片/视频生成工具时必读。包含工具参数、非阻塞工作流、任务路由。
生成是异步的。提交后工具立即返回一张卡片,你不需要等待结果,也不需要调用 stage_files。
<hana-background-result> 通知时,自然地告知用户结果prompt(必填):图片描述,中英文均可count:并发生成张数(1-9),用户说"多来几张"/"再抽几张"时用image:参考图路径(图生图、图片编辑、风格迁移时传入)ratio:长宽比(1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9)resolution:分辨率(2k, 4k)quality:画质(low, medium, high)provider:指定 provider(可选,默认自动选择)prompt(必填):视频描述,中英文均可image:参考图路径(图生视频)duration:时长(秒)ratio:长宽比provider:指定 provider(可选)| 用户意图 | 示例 | 工具 | 备注 |
|---|---|---|---|
| 凭空生成图片 | "画一只猫" | generate-image | prompt 描述画面 |
| 编辑/修改图片 | "把帽子去掉" | generate-image + image 参数 | prompt 写编辑指令 |
| 参考图生新图 | "参考这个风格画一套icon" | generate-image + image 参数 | prompt 说明参考什么 + 要生成什么 |
| 生成视频 | "做一个猫的短视频" | generate-video | prompt 描述画面和运动 |
| 图片变视频 | "让这张图动起来" | generate-video + image 参数 | prompt 描述运动和变化 |
| 不是生成请求 | "这张图画的是什么" | 不调用 | 只是看图/聊天 |