SuperAPI AI 工具集

dreamina-canvas-quote-and-run

智能体与模型

查看项目

更新于 10-15 21:47

技能介绍

用途:在结构工作完成且用户已授权花费后,安全地运行已保存的 Dreamina Canvas 节点。它负责付费执行的安全事务,流程固定为:针对最新权威草稿做节点报价(node quote),再节点确认(node confirm)把用户批准绑定到确切的信用额度上限,最后用调用方生成的 submitId 执行 node run。

主要能力与用法:

  1. 报价:dreamina-canvas --format json node quote --node-id <nodeId> --project-id "$PROJECT_ID",返回 items[]、totalMaxCredits、confirmable、confirmationRequired、creditConfirmation.minimumCreditCeiling。
  2. 确认:node confirm 需 --node-id、--project-id、--credit-ceiling,生成短期信用批准令牌。若任一节点不可报价,或额度上限低于最新总额(返回 Conflict),则拒绝签发。
  3. 运行:node run 需 --node-id、--project-id、--credit-token、--submit-id。批量时每个 --node-id 对应一个 --submit-id,长度与顺序一致。

绑定规则:信用令牌绑定“谁+哪个画布+哪批节点+额度上限+批次摘要”,不绑定提示词文本。因此确认与运行之间修改提示词可行,只要最新实时报价仍在批准额度内;令牌不能移到不同节点集,换节点需重新确认。

submitId 是唯一计费身份:自行生成小写 UUID 并在运行前持久化;重试复用同一 submitId 会重放原提交且不重复计费,换新 ID 则重新计费。显式空 --submit-id "" 会以退出码 2 拒绝,防止未设置的 shell 变量静默生成新幂等键。

恢复规则:模糊或超时响应按 ID 对账,不重新提交;operationRef(submitId 别名)传给 operation status 或 operation wait。仅当 submission.state 缺失且 resubmittable=true 时才允许重新提交;缺失 submission 字段视为“服务器已接受”,不得当作 absent,否则会重复计费。退出码 20 表示 resume,重试前须重新报价。

限制:不持久化信用批准令牌、签名 URL、Cookie、OAuth 令牌或供应商任务标识;不用过期草稿重新报价;重试不生成新 submitId;不依据本地化消息文本分支,只看退出码、error.code、error.requiredAction;价格可预知时不用 --yes 代替 --credit-ceiling。调用前提:已安装 dreamina-canvas,用户提供 projectId、nodeIds、submitId 与信用额度上限,并在操作时明确批准花费。