dreamina-cli

Dreamina CLI

当你需要使用 Dreamina（即梦）生成图像或视频、查询任务、列出任务、检查积分或管理会话时，请使用此技能。

即梦是 Dreamina 的中文产品名称。如果用户说“即梦”，请将其视为 Dreamina，并使用此技能。

优先使用 scripts/ 中打包的 Python 包装脚本，而不是直接调用原始 dreamina。这些包装脚本提供路径验证、命令规范化、结构化 JSON 输出、--dry-run 和一致的错误处理。

如果不清楚某个标志或支持的取值，请以 dreamina -h 和 dreamina <subcommand> -h 为最终依据。

默认工作流

1. 如果需要发现功能，请运行 python3 ./scripts/list_capabilities.py --format json。
2. 根据用户的请求，选择最精简的包装脚本。
3. 对于成本较高或含糊不清的请求，请先使用 --dry-run 运行包装脚本，检查确切的 CLI 参数。
4. 运行实际的包装脚本命令。
5. 阅读包装脚本返回的 JSON 响应，不要只依赖 shell 退出代码。
6. 对于异步生成，请保留返回的 submit_id；如果用户希望后续轮询，请使用 query_result.py。

脚本选择

• 图像生成：
  • text2image.py
  • image2image.py
  • image_upscale.py
• 视频生成：
  • text2video.py
  • image2video.py
  • frames2video.py
  • multiframe2video.py
  • multimodal2video.py
• 任务和账户操作：
  • query_result.py
  • list_task.py
  • user_credit.py
• 会话操作：
  • login.py
  • login_checklogin.py
  • logout.py
  • relogin.py
  • session.py
• 功能发现：
  • list_capabilities.py
• CLI 版本检查：
  • version.py

输出约定

每个包装脚本都会返回 JSON，包含：

• ok：布尔值
• command：包装脚本命令名称
• cli_args：完整展开的命令数组
• data：成功时解析后的 CLI 负载
• error 和 details：失败时规范化后的错误负载

对于生成包装脚本，只有满足以下条件时，才将提交视为有效：

• 存在 submit_id
• gen_status 为 querying 或 success

如果生成包装脚本返回 gen_status=fail，包装脚本会将其转换为 ok: false。

安全规则

• 除非用户明确要求登录、登出或重新登录，否则请复用当前登录会话。
• 确实需要调用登录或重新登录时，优先使用 --headless 标志（例如 python3 scripts/login.py --headless）输出 OAuth Device Flow 授权信息。用户在浏览器中完成授权后，请使用 python3 scripts/login_checklogin.py --device-code <device_code> --poll 30。
• 某些模型可能需要一次性 Dreamina Web 确认。如果 CLI 报告 AigcComplianceConfirmationRequired，请告知用户完成网页端授权后重试。
• 目前，CLI 通过 text2image 和 image2image 上的 --model_version=5.0Pro 提供 Seedream 5.0 Pro。
• 5.0Pro 支持 1k、2k 和 4k 三种 resolution_type 取值；图像生成默认使用模型 5.0，而非 5.0Pro。
• 图像生成和放大必须指定 resolution_type；每个视频生成命令都必须指定 video_resolution。
• text2image 和 image2image 支持成对使用 --width / --height；自定义尺寸不能与 --ratio 同时使用。
• 图像生成包装脚本支持通过 --generate-num / --generate_num 设置 CLI 的 generate_num，取值范围为 1-10。
• 当前 CLI 帮助中，seedance2.0mini 是受支持的 Seedance 2.0 视频模型；除非未来的 dreamina <subcommand> -h 输出另有说明，否则请按仅支持 4-15 秒和 720p 处理。
• seedance2.5 支持 480p/720p 和 4-30 秒的视频输出。其多模态模式接受纯音频输入，并使用更高的模型专属输入上限。
• 优先使用规模较小、便于审核的生成批次。
• 记录所有异步任务的 submit_id。
• 对于受支持的命令，除非用户明确要求使用原始 CLI 执行，否则不要绕过包装脚本。

参考资料

• 有关封装器清单、参数和示例，请阅读 references/commands.md。
• 有关 Vibe Coding IDE 的使用，以及 OpenClaw 或 DeerFlow 风格 Agent 运行时的可移植性指南，请阅读 references/integration.md。