Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
即梦画布参考素材视频
When to use
仅处理 参考素材视频。输入：图像/视频/音频参考；单图与多模态用 m2v，首尾两张图按序用 firstlastframe；无 i2v 或 multi_modal 模式。 提示词尚未确定时交给 dreamina-prompt-image2video；不能未经用户要求改写最终提示词。
Sunset notice：本技能替代旧 dreamina CLI 的对应生成路径。
操作契约
| 项目 | 标准 |
|---|---|
| 输入与前置 | 用户确认的提示词、当前模型规格、projectId 及模式所需参考 |
| 副作用 | 不带 --run 的节点写入保存草稿；付费执行走公共 execution 操作 |
| 输出交接 | 返回的 nodeId 与 projectId；生成后另附 submitId 和校验后的资源 |
| 恢复规则 | 恢复使用原 submitId；只有明确 absent + resubmittable 才按原身份恢复提交 |
Workflow
Step 1：复用 dreamina-canvas-cli 的公共调用契约和已确认 projectId；缺少安装或登录时按名称交给 setup/auth 技能。
Step 2：从当前模型/音色查询结果校验模式参数，读取 参数规范。不套用旧 CLI 的 modelversion、resolutiontype 或 poll。
Step 3：保存草稿，记录返回的 nodeId；修改已有节点时先读取当前状态，完整替换生成参数和引用，元数据才是稀疏更新。
bash
dreamina-canvas --format json node create video --project-id <projectId> \
--prompt "<prompt>" --mode m2v --model <model> --ratio <ratio> --duration <seconds> --ref node:<nodeId>Step 4：需要生成时交给 dreamina-canvas-cli 的 execution 操作：node quote → node confirm → node run。提交前记录稳定 submitId；任务技能不自行批准预算。
Step 5：交给同一公共技能查询恢复与下载校验，核对本模式的实际产物。超时不换 submitId 重提。
Rules
- 占位参数必须替换为当前 CLI 返回或用户确认的值；草稿命令不加 --run。
- 不混用其他模式的必填项，批量上限从模型能力查询。
- Never persist tokens, cookies or signed URLs；恢复只保留非敏感身份。
- 缺少配套技能时安装：
npx skills add full-aigc-skills/dreamina-skills --skill <skill-name>。
Progressive disclosure（按需读取）
- 需要逐 flag 的必填/取值/冲突规则时，读取 参数规范。
- 需要从当前 discovery 结果选模型、比例、分辨率或时长时，读取 模型或音色选择。
- 需要批量、异步、多项目、迭代等成段工作流时，读取 常用场景组合。
- 遇到超时、部分成功或恢复场景时，读取 异常处理。
- 交付前自检时，读取 验收清单。
- 首次运行看 成功场景；批量/异步/多项目/拒绝越权/失败恢复样例见
examples/目录。
Validation checklist
- [ ] 输入与 m2v / firstlastframe 模式一致，参数经过实时发现。
- [ ] 返回的 projectId、nodeId 与 submitId 正确交接，不能将受理视为完成。
- [ ] 输出终态成功，下载后校验媒体类型、字节数和 SHA-256。
Gotchas
- 节点生成编辑是 full replace，不能丢失原有引用。
- 登录状态、计费权限与生成成功是不同检查。
- 只生成用户要求的数量，不自动追加尝试。
不适用与边界
不适用于纯文字视频或本地剪辑。不能把两个普通参考图自动解释为首尾帧，先根据用户意图选择模式；只拿到参考链接不代表已生成。
只读取当前操作必要的账户与素材信息；不存储、记录或输出访问令牌、cookie 和临时签名链接。
