运行时依赖
安装命令
点击复制技能文档
Dreamina CLI
当您需要通过 Dreamina(即梦)生成图像或视频时,请使用此技能。如果用户说“即梦”,请将其视为 Dreamina 并使用此技能。此技能故意简短。详细标志和支持值属于 CLI 本身,因此始终将 dreamina -h 和 dreamina -h 视为主要参考。
此工具的用途是:Dreamina 的本地 CLI 入口点,用于所有当前公开的 Dreamina(即梦)图像和视频生成工作流,以及它们周围的帐户/会话操作。使用它来:
检查或重用现有的 Dreamina 登录会话 检查帐户信用 提交图像生成任务 提交视频生成任务 查询异步任务结果 查看已保存的任务历史记录
默认工作流 当使用此 CLI 作为代理时:
- 从
dreamina -h开始。 - 在使用任何命令之前,运行
dreamina -h。 - 除非用户明确要求登录、重新登录或退出,否则重用当前登录状态。
- 明确说明您是否只阅读帮助、提交实际任务或查询现有任务。
- 在运行可能消耗信用命令之前,警告用户。
选择正确的命令
高层次上:
使用 user_credit 检查预算。
当您已经有 submit_id 时,使用 query_result。
使用 list_task 查看最近保存的任务。
当输入或输出是图像优先时,使用图像命令。
当输出是视频时,使用视频命令。
当一个主要图像足够时,使用 image2video;如果用户有多个图像用于连贯的故事,首选 multiframe2video。
使用 multiframe2video 进行 Dreamina 的智能多帧流:多个图像输入,一个连贯的故事视频输出。
使用 multimodal2video 进行 Dreamina 的旗舰视频模式,当任务需要跨图像、视频和音频的全方位参考时;它支持 seedance2.0 家族。
对于确切的标志和支持组合,请依赖每个子命令的 -h。
模型选择规则
不要在此技能中硬编码模型支持。如果用户指定模型,在运行之前始终检查相关子命令帮助:dreamina -h
使用子命令帮助确认:
是否该命令暴露模型选择
请求的模型是否在该命令中受支持
应用于该模型的其他约束,例如持续时间、比率或分辨率
附加指南: 一些命令根本不暴露模型选择 一些模型,尤其是 seedance2.0 家族,可能是容量受限的 如果用户更关心速度而不是最大质量,则除非他们明确要求,否则不要默认为 seedance2.0
如何判断提交成功
不要仅依赖 shell 退出代码。对于异步生成命令,只有当:
submit_id 存在
gen_status 是查询或成功
如果 gen_status 是失败,请检查 fail_reason 并告诉用户具体原因。
异步任务的后续模式
在提交返回查询后:
保存 submit_id。
使用 query_result --submit_id= 进行后续。
当您想要批量查看已保存任务时,使用 list_task。
如果您正在运行测试扫描,请以机器可读的格式保持结果,以便稍后查询返回的 submit_id 值。
重要的用户面向规则
一些生成命令是异步的;提交和查询是分离的步骤。
一些模型可能需要在 Dreamina Web 上进行一次性授权。
如果 CLI 返回 AigcComplianceConfirmationRequired,请告诉用户首先在 Web 上完成该确认,然后重试。
不要假设不同的命令支持相同的模型、比率、持续时间或分辨率。在使用之前检查每个子命令的 -h。
良好的代理行为
在运行实际生成任务时,优先使用小型、可审查的批次。
为每个付费测试保留命令、参数、submit_id 和最终状态的记录。
当用户关心生成速度时,除非他们明确要求或明确优先输出质量,否则不要默认为 seedance2.0 家族。
如果您正在准备报告,请分离:
+ 帮助仅检查
+ 提交阶段验证
+ 后续异步结果跟进