无限画布项目设置

使用前准备

先完成 ai-short-studio preflight --json 并登录。该能力仅适用于 INFINITE_CANVAS 项目；新建项目前还必须在设置中心配置默认分析模型。

操作步骤

先读取服务端实时配置和版本：

ai-short-studio canvas settings get --project "$PROJECT_ID" --json

确认返回字段的 currentValue、effectiveValue、source 和 options 后，使用文件或 stdin 一次提交已确认的字段：

{
  "expectedVersion": 3,
  "values": {
    "aspectRatio": "9:16",
    "storyboardGridSize": 6,
    "videoModel": null
  }
}

ai-short-studio canvas settings set --project "$PROJECT_ID" --file settings.json --json

null 或空字符串会清除项目覆盖值，恢复账户配置或系统默认值。默认分镜格数为 6；分镜图节点可通过 gridSize 逐镜覆盖。画风、画幅、分镜布局、格数和模型必须从本次 settings get 或节点目录返回的实时选项中选择。

视频提示词类型

videoPromptType 可选择 h3 或 seedance，项目未保存有效值时默认为 seedance。它控制无限画布“故事版视频提示词”节点采用哪套改写规则：节点自己的 promptType 为有效值时优先；节点未设置或值无效时继承项目配置；项目也没有有效值时才回退为 seedance。节点编辑器中选择“使用项目配置”会清空节点覆盖值，恢复继承。

在页面中显式选择视频模型时，系统会同步建议对应类型：comfly::minimax-h3、runninghub::minimax-h3-reference-to-video 和 comfyui::minimax-h3-reference-to-video 自动选择 h3，其他显式模型自动选择 seedance。随后手动选择的视频提示词类型优先于模型建议；通过接口在同一次请求中同时提交 videoModel 与 videoPromptType 时，也以显式的 videoPromptType 为准。清空 videoModel 时，客户端不会根据空值猜测类型，服务端会根据最终生效的视频模型完成映射。

H3 使用系统内置的 H3 Ref2VA 改写模板；Seedance 保留原有的分镜参考、镜尾转场与后处理流程。outputLanguage 接受任意规范 BCP 47 语言标签，如 fr、pt-BR 或 zh-Hant；清空后自动跟随输入内容的主要语言。任务的页面语言决定加载中文或英文模板，outputLanguage 只作为内容输出语言要求传入当前模板，不会切换模板文件。CLI --locale 只控制命令界面，不代替内容语言。

结果与状态

写入成功后会返回递增后的 version 和完整字段状态。修改 videoPromptType 只会把“故事版视频提示词”和下游视频生成节点标记为需要重算；修改 outputLanguage 只会标记受语言影响的文本、提示词、语音与视频节点。两种修改都不会自动启动节点，也不会自动提交付费任务。创作前应再次读取并确认最终生效值；设置未确认或所需模型不可用时，不应创建或执行付费节点。

权限和边界

所有者和管理员可修改，协作者只能读取。canvas apply 只处理节点、连线和视口等画布图数据，不能替代项目设置接口。选择画风会保存当时关联的视觉圣经快照；同一请求显式提供 visualBible 时，以显式内容为准。

常见问题

遇到 HTTP 409 表示版本已变化。重新运行 canvas settings get，核对变化并使用新的 version 重试，不要盲目覆盖。模型或枚举值被拒绝时，应重新读取实时 options，不要复用旧文档中的值。