AIVideo/workflows/novel_to_seedance/references/attachment_reference_rules.md

# 附件引用与 @ 标签规则

## 核心结论

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

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

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

在 API 里：

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

## Web 官网手动上传写法

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

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

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

## 参考职责写法

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

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

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

## API 写法

通用结构：

```json
{
  "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。