agentleFS
full-aigc-pluginsfull-aigc-plugins/dreamina-design-plugin/skills/dreamina-cli-text2video/SKILL.md

dreamina-cli-text2video

Skill0 starsChanged 23 days agoApache-2.0View on GitHub

仅在用户明确要求旧版 dreamina CLI、恢复旧版 submit_id 或排查历史命令时使用;冻结兼容技能,新任务转交对应 dreamina-canvas-cli 技能。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

即梦 CLI 文生视频

⚠️ 停维护公告:旧版 Dreamina CLI(dreamina,v1.4.18)将于 2026 年 11 月 起停止维护。新任务请改用 Canvas 替代技能 dreamina-canvas-cli-text2video(安装:npx skills add full-aigc-skills/dreamina-skills --skill dreamina-canvas-cli-text2video)。本技能内容保留作历史契约参考。

执行前先运行 dreamina text2video --help。本技能记录 v1.4.18 稳定工作流;实际 help 始终是参数事实源。

When to use and boundary

用于无参考媒体的 CLI 文生视频提交、轮询和故障诊断。不该用于图生视频、故事板或单纯提示词创作;改用 dreamina-cli-image2video 或 prompt 技能。

协作路由:dreamina-prompt-text2video 负责视频提示词;本 Skill 负责本地 dreamina CLI 执行;用户明确选择 OpenCLI 传输时改用 dreamina-opencli-text2video,不要重复提交。

必须遵守

  • 每次提交显式传 --video_resolution,token 必须是小写 480p/720p/1080p/4k。480p 仅 seedance2.5 支持。
  • seedance2.0_vip 支持 720p/1080p/4k;其他 Seedance 2.0 家族模型仅支持 720p。
  • seedance2.5:480p/720p/1080p,时长 4–30 秒。
  • 在运行时从 dreamina text2video --help 发现比例取值;v1.4.18 为 1:1、3:4、16:9、4:3、9:16、21:9,省略 --ratio 时默认 16:9。
  • 文生视频公开模型仅为 Seedance 2.0 家族与 seedance2.5,不要传旧 3.x 或 Seedance 1.x token。
  • Seedance 2.0 家族时长 4–15 秒,默认模型 seedance2.0fast;seedance2.5 时长 4–30 秒。
  • 提交前说明会消耗积分;耗时场景优先异步提交。

标准执行

dreamina user_credit
dreamina text2video \
  --prompt="镜头缓慢推进,一只橘猫在窗台伸懒腰,晨光穿过窗帘" \
  --duration=5 \
  --ratio=16:9 \
  --model_version=seedance2.0fast \
  --video_resolution=720p \
  --poll=0

VIP 高分辨率:

dreamina text2video \
  --prompt="航拍海岸线,浪花沿岩石展开,电影感长镜头" \
  --duration=8 \
  --ratio=16:9 \
  --model_version=seedance2.0_vip \
  --video_resolution=1080p \
  --poll=0

v1.4.18 Seedance 2.5 长视频(4–30 秒,480p/720p/1080p):

dreamina text2video \
  --prompt="延时摄影:城市从黎明到夜空的连续变化,云层流动,灯光渐次亮起" \
  --duration=20 \
  --ratio=16:9 \
  --model_version=seedance2.5 \
  --video_resolution=720p \
  --poll=0

异步闭环

Step 1:验证

运行 dreamina text2video --help,在运行时校验模型、duration、--ratio 与分辨率组合。

Step 2:提交

检查积分、说明消费影响、异步提交并保存 submit_id。

Step 3:终态闭环

对 querying 持续调用 query_result,直到 success 或 fail。失败时报告 fail_reason。遇到 AigcComplianceConfirmationRequired 时提示用户先在 Web 端完成授权。

Gotchas

  1. 分辨率遗漏:每次都必须传 video_resolution。
  2. token 大小写:使用 480p/720p/1080p/4k,不是大写 P。
  3. 模型越界:文生视频不接受 Seedance 1.x 或旧 3.x。
  4. 高分辨率误用:seedance2.5 可用 1080p 但不可用 4k;其他模型以当前 help 为准。
  5. 时长越界:Seedance 2.0 家族 4–15 秒,seedance2.5 4–30 秒,超出会被拒。
  6. 长任务误判:poll 超时仍为 querying 时继续查询,不立即重提;长视频尤其需要更长 --poll。

References

<!-- QUALITY_BASELINE_V1 -->

When to use(什么时候使用)

当用户需要 在明确输入、预算和交付约束后执行生成或写入操作 时加载本技能。先从请求中提取目标、输入、约束、交付格式和验收标准;描述摘要为:Use when the user wants to submit, poll, or troubleshoot Dreamina 即梦 text-to-video tasks through dreamina text2video. Covers CLI v1.4.18 runtime ratio discovery, required video resolution, Seedance model constraints, sessions, and async terminal statuses.。

Rules

  • 先读后写:先确认当前状态与真实能力,再执行会改变外部状态的动作。
  • 权限最小化:只使用完成当前步骤所需的文件、工具、账户与网络范围。
  • 证据优先:运行结果、资源 ID、版本、哈希或测试输出缺失时,明确标记为 NOT_VERIFIED。
  • 幂等优先:保留请求标识与阶段状态;结果不明确时先查询,不进行盲目重试。
  • 隐私安全:日志、示例、回执和错误信息不得包含 token、cookie、密钥或个人敏感数据。

Workflow

Step 1:澄清意图

确认本技能是否匹配目标;若只是相邻需求,交给更精确的技能。

Step 2:执行预检

校验输入、模型/工具能力、输出路径、预算上限和审批状态;任一关键条件未知时停止在只读阶段。

Step 3:形成计划

列出将调用的工具、会改变的对象、成功标准以及失败后的安全退出方式。

Step 4:执行动作

按一次批准执行并记录请求标识;模糊结果先查询而不是重提;每个外部调用均保留可关联的状态或回执。

Step 5:验证交付

验证产物存在性、格式、哈希/标识、成本状态和质量门禁,并把事实、推断和未验证项分开陈述。

Validation checklist

  • 技能触发条件与用户意图一致,没有把相邻任务误路由到本技能。
  • 输入、目标对象、版本和输出位置均已明确,且没有使用猜测值替代必填值。
  • 所有写入、付费、发布或不可逆动作都在用户授权范围内。
  • 结果已用独立检查验证;仅有“命令成功”或“文件存在”不算完整验收。
  • 输出包含实际证据、失败/跳过项、剩余风险和可执行的下一步。

Gotchas

  1. 把计划当结果:文档或提示词不等于真实执行;必须标明实际运行层级。
  2. 错误重试:超时或响应丢失可能已经产生远端状态,先查询再决定是否重试。
  3. 隐式扩大范围:批量、全量、发布、覆盖和付费不是普通读写的自然延伸。
  4. 版本漂移:引用外部资源时记录版本、tag 或提交;不要把可变分支当发布证据。
  5. 证据过期:缓存、旧截图和历史测试不能证明当前环境;在交付前刷新关键证据。

不适用与边界

付费、发布、覆盖、上传或外部写入必须使用当前任务的显式授权;不自动扩大次数和预算。 如果请求需要别的技能,不复制其正文;按技能名称进行交接,并保留当前任务上下文。

Progressive disclosure

  • 需要确定输入/输出、状态和授权点时,读取 references/workflow-contract.md。
  • 需要交付前自检时,读取 references/validation-checklist.md。
  • 遇到超时、部分成功或恢复场景时,读取 references/error-recovery.md。
  • 首次运行、拒绝越权和失败恢复分别参考 examples/happy-path.md、examples/boundary-refusal.md、examples/failure-recovery.md。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.