用途:该技能负责 Dreamina Canvas 的图像节点,包括保存草稿、编辑节点,以及从草稿进入付费链之前的过渡。它不批准花费,付费执行由 dreamina-canvas-quote-and-run 负责。
主要能力:支持创建文本生图(t2i)与图生图(i2i)草稿;支持在已有草稿上切换 t2i 与 i2i;支持在不丢失节点身份的前提下清除生成内容;支持通过 --ref 组合有序引用。引用格式为 type:value,图像生成中一等类型为 node:node_xxx(引用该节点最新资源,形成画布边,源节点重新生成时引用跟随)与 res:<小写UUID>(冻结到特定资源,无画布边,不受源节点重新生成影响)。uri: 与 vid: 为保留类型,当前被服务器拒绝。t2i 不接受图像、Element 或资源引用;i2i 至少需要一个图像、Element 或图像资源引用,可额外包含文本引用。--prompt 中的 {{type:value}} 占位符在提示词中被提及时会转为引用,与显式 --ref 混用时按首次出现去重(先提示词顺序,后 --ref 顺序);字面 {{ 需写成 {{{{。
使用方式:创建 t2i 草稿示例:dreamina-canvas --format json node create image --title "<title>" --prompt "<prompt>" --mode t2i --model <model> --ratio <ratio> --resolution <resolution> --count <n>。创建 i2i 草稿需至少一个图像引用,例如 --ref node:<sourceNodeId> 或 --ref res:<frozenResourceUuid>。仅当引用使模式明确时可省略 --mode;一旦任何生成参数变化,必须显式传 --mode。生成编辑(修改 --mode、--model、--ratio、--resolution、--count、--prompt、--ref)为整体替换,必须提供完整的新生成块,省略参数即清除该参数;元数据编辑(title/description/tags)为稀疏更新,仅更新传入的字段。清除生成使用 --clear-generation,仅对 node edit 有效,且与所有生成标志互斥。图像放大使用 node upscale image,会创建新节点且不覆盖源节点,属于单独定价操作,需要放大范围的审批令牌,node confirm 的令牌在此无效;执行前应为每个源持久化一个稳定的 submitId,遇到 exit 20 或 21 时用同一 ID 查询或重试,不得替换新身份。
适用场景:调用方需要保存或更新图像节点(可带或不带其他节点、资源引用);需要在已有草稿上切换 t2i 与 i2i;需要清除生成但保留节点身份。
限制:不批准花费;不持久化令牌、签名 URL、cookie 或会话材料;不将生成编辑当作部分更新;不在公开模式为 m2v/t2i 等时传入 multi_modal 等服务器内部别名;不自行调用 --run,不提供 --credit-ceiling 或 --credit-token。调用需已确认安装 dreamina-canvas,并具备图像模型的实时发现结果;付费执行必须显式交接给 dreamina-canvas-quote-and-run。