AIVideo/workflows/novel_to_seedance/references/attachment_reference_rules.md
luoqian 2eb629fe4b 新增图片生成与上传执行管线:nano-banana-2真实出图→上传→公网URL回填→上传后二次生成API调用稿
- 新增 image_generation_upload_rules.md、post_upload_call_draft_rules.md 规则文件,scripts/ 脚本目录
  - 工作流新增阶段 5.1 图片生成与上传、5.2 上传后调用稿分支,调整原有步骤编号
  - 所有模板和规则强制要求:API 图片输入使用上传后的公网 URL / asset:// URI,禁止本地路径或占位符
  - 官网 Prompt 模板强制要求使用 @官网上传名,绑定已上传资产
  - 附件/API 资产清单新增状态追踪列(pending_generation / pending_upload / generated_uploaded_ready 等)和 uploaded_assets.json 回填规则
  - api_payload_rules.md 新增"上传后二次生成硬约束",要求 JSONL 必须在图片上传完成后基于真实 URL 重新生成
  - image_model_provider_rules.md 明确 nano-banana-2 为默认执行资源(非仅提示词名称),新增图片生成/上传执行标记

  ---
  核心变更概括:工作流从"只写提示词"升级为"提示词→真实出图→上传→获取公网 URL→回填→二次生成调用稿"的完整资产管线。
2026-05-26 15:45:46 +08:00

3.3 KiB
Raw Blame History

附件引用与 @ 标签规则

核心结论

@角色名@场景名@道具名 是本工作流内部的资产引用名,不等于平台已经拿到了图片。

在即梦官网、Seedance Web 或其他网页端:

  • 必须先生成并上传图片/视频/音频附件。图片资产优先按 image_generation_upload_rules.md 由 nano-banana-2 生成并上传。
  • 提示词只能描述这些附件的用途例如“参考已上传的角色图1作为姜尚离外貌”。
  • 不要指望在纯文本里写 @姜尚离 就自动附带图片。

在 API 里:

  • 先上传图片或提供公网可访问 URL。
  • 请求体里传 image_urlscontent 或类似字段。
  • 提示词里用平台规定的标签引用,例如 @Image1@Image2
  • 本地路径不能直接进入 API。图片上传接口返回的公网 URL 才能作为 image_url.url

Web 官网手动上传写法

每条视频提示词前输出一个“附件清单”:

附件:
图1@姜尚离_百姓装_主形象
图2@霍念_粗布农夫_主形象
图3@伯府狗洞_泥地_场景
图4@旧玉佩_道具

提示词:
参考图1作为姜尚离的外貌、发型和服装参考图2作为霍念的外貌和服装参考图3作为场景空间和光线参考图4作为旧玉佩道具。生成……

参考职责写法

每个附件必须有明确职责,避免模型把背景、姿势、服装、表情混用:

  • 角色图:锁定外貌、发型、服装、固定识别点;不参考原图背景和姿势,除非本段明确需要。
  • 场景图:锁定空间结构、材质、光线方向;不改变角色身份。
  • 道具图:锁定外观、尺寸、材质;不新增危险用途说明。
  • 视频参考:只锁定动作节奏、镜头路线、运动速度;不复制视频中的人物身份。
  • 音频参考:锁定节奏、氛围、对白语气或环境声方向;如果本段由 Seedance 生成声音,对白/VO/环境音必须写进 Seedance Prompt。

同一条提示词建议使用 2-5 个核心附件;除非确有必要,不要把所有全局资产都塞进同一个任务。

API 写法

通用结构:

{
  "prompt": "@Image1 as Jiang Shangli character reference, @Image2 as Huo Nian character reference, @Image3 as the alley scene reference. ...",
  "image_urls": [
    "https://example.com/jiang-shangli.png",
    "https://example.com/huo-nian.png",
    "https://example.com/alley.png"
  ],
  "duration": 12,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

不同 API 服务商字段名可能不同:

  • 有的用 image_urls
  • 有的用 content: [{"type":"image_url", ...}, {"type":"text", ...}]
  • 有的需要先获取预签名上传 URL再用返回的 file_path 提交任务。

本工作流输出要求

每条即梦和 Seedance 提示词必须同时输出:

  1. 内部引用@姜尚离_百姓装
  2. 官网附件清单图1、图2、图3分别上传什么。
  3. 参考职责:每张图/视频/音频负责锁定什么,不参考什么。
  4. 官网提示词用“参考图1/图2/图3”写。
  5. API映射@Image1 = @姜尚离_百姓装
  6. API提示词:用 @Image1/@Image2 或“参考图1/图2”写。
  7. 公网URL:来自上传接口的 URL未生成或未上传时写明 pending_generation / pending_upload,不得假造 URL。