08-参考图提示指南

1.1 什么是图像提示词

图像提示词让你可以通过在文本提示词中加入图像 URL 来引导悠船创作。悠船会分析你图像的核心元素——色彩、构图、主体等——并将其作为创建全新且独特图像的灵感来源。

简单来说：把图片链接放进提示词，悠船就会参考这张图片来生成新的图像。

1.2 使用方式

图像提示词有三种用法：

方式一：单一图像 + 文本提示词

图片url 文本提示词

选择一张与你设想相似的图像，然后添加描述性文本。文本提示应包含你希望在最终图像中看到的所有内容，而不是修改参考图像的指令。

方式二：多张图像（无文本）

图片url1 图片url2 图片url3

上传两张或更多图像而不添加文本，将它们混合在一起。如果你希望悠船专注于视觉元素的融合，这种方法非常适合。

方式三：多张图像 + 文本提示词

图片url1 图片url2 文本提示词

将多张图像与描述性文本结合，获得更详细的指导。使用文本提示来指定参考图像中不可见的重要细节。

格式说明：

• 多张图片之间用空格分隔

1.3 图像权重（--iw）

图像权重参数 --iw 用于控制图像提示对最终图像的影响程度。

• 不设置 --iw 时，悠船使用默认值

• 权重越高，图像提示对成品图像的影响越大

• 权重越低，文本提示的影响越大

各模型版本的图像权重范围：

1.4 注意事项

• 要使提示词有效，你需要使用多个图像提示，或者一个图像提示 + 一个文本提示的组合（不能只放一张图片且无文本）

• 图像文件格式必须是 .png、.gif、.webp、.jpg 或 .jpeg

• 为获得最佳效果，将图像裁剪为与最终图像相匹配的宽高比

• 仅使用图像而没有文本的提示，与 --stylize 或 --weird 参数不兼容

1.5 API 调用方式

在悠船开放平台 API 中，图像提示词通过 text 字段传入。将图片 URL 直接写在文本提示词前面，用空格分隔：

import requests

url = "https://ali.youchuan.cn/v1/tob/diffusion"
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}
data = {
    "text": "https://example.com/ref-image.jpg A beautiful sunset over the mountains",
    "callback": "https://your-callback-url.com"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

2.1 什么是角色参考

角色参考允许你在多个图像中重新创建特定角色。通过使用你喜欢的角色图片，悠船可以识别角色的特征（如发色、服装、面部特征等），并使用这些细节在新场景中生成该角色，帮助在不同图像之间保持角色一致性。

重要： 角色参考与版本 7 不兼容。如果使用 V7 模型，请改用"万物引用"（--oref）功能。

2.2 使用方式

在提示词末尾添加 --cref 参数，然后粘贴图像 URL。多张图片用空格分隔：

一个蓝发戴金色眼镜的男人坐在咖啡馆里 --cref 人物图片Url

使用多张参考图：

一个蓝发戴金色眼镜的男人坐在咖啡馆里 --cref 人物图片Url1 人物图片Url2

2.3 最佳实践

• 使用悠船图像：为获得最佳效果，从悠船创建的单个角色图像开始。真实人物的图像通常不会完全像他们本人

• 限制角色参考：虽然可以使用同一角色的多张图像，但通常没有必要

• 注意细节：像特定雀斑或服装上的标志等精细细节可能不会完全准确呈现

• 使用详细的文本提示：将角色参考与清晰的文本提示结合使用。文本对于传达参考图像之外的完整场景和额外细节同样重要

2.4 提示词写法对比

错误写法（把图像当作指令对象）：

• "把这个男人放在咖啡馆里"

• "在咖啡馆环境中添加这个男人"

正确写法（描述你想要的场景）：

• "一个蓝发戴金色眼镜的男人坐在咖啡馆里"

• "一个人独自坐在咖啡馆里的插图"

核心原则：文本提示描述的是你想看到的最终画面，而不是对参考图像的修改指令。

2.5 角色权重（--cw）

角色权重就像一个调节器，让你选择参考图像中有多少细节出现在新图像中。

• --cw 100（默认值）：尽可能多地包含面部、头发和服装等细节

• --cw 0：重点主要放在角色的面部

• 取值范围：0 - 100

这使你可以灵活调整从参考图像中提取的细节量。

重要提示： 悠船使用图像提示和参考作为指导新创作的灵感，而不是精确复制它们。

2.6 兼容性说明

• 角色参考需要将文本提示与参考结合使用

• 图像文件格式：.png、.gif、.webp、.jpg、.jpeg

• 可以与悠船 v6、v6.1 和 Niji 6 一起使用

• v7、v8.1、Niji 7 不支持，v7 请使用万物引用（--oref），v8.1 无角色/万物引用功能

• 可以与风格参考（--sref）和图像提示词同时使用

3.1 什么是风格参考

风格参考是一种捕捉现有图像视觉氛围并将其应用到你的新悠船创作中的方法。它不会复制对象或人物，只复制整体风格——如颜色、媒介、纹理或光照——帮助你实现一致的视觉主题。

此功能与 V7 兼容。 说明和设置保持准确，但随机风格代码与 V6.1 产生不同的风格。

3.2 使用方式

在提示词末尾添加 --sref 参数，然后粘贴图像 URL。多张图片用空格分隔：

一只狗的详细肖像 --sref 图像Url1 图像Url2

3.3 最佳实践

• 保持文本提示简单：避免添加可能与参考图像外观冲突的风格词

• 有选择地添加风格词：如果很难实现特定风格，包含与参考图像匹配的描述性词语

• 专注于内容，而非指令：使用文本提示描述你想看到的内容，而不是悠船应如何修改参考图像

3.4 提示词写法对比

错误写法：

• "这个图像的外观但是一只狗"

• "复制这个风格并制作一只兔子"

正确写法：

• "一只狗的详细肖像"

• "圆珠笔素描的兔子"

3.5 风格权重（--sw）

风格权重参数 --sw 允许你控制参考图像的风格对新图像的影响程度：

• 取值范围：0 - 1000

• 默认值：--sw 100

• 值越高，风格影响越强烈

3.6 随机风格和代码（--sref random）

在提示中使用 --sref random，悠船将从其内部库中随机选择一个预设风格。

• 提交提示后，"random" 将转换为数字代码（sref 代码）

• 你可以在未来的提示中重用该代码来获得相同的风格

• 使用重新运行/重新随机或变化时会保持相同的代码和风格

• 使用 --sref random 配合排列或 repeat 参数时，每个图像都会有不同的风格和代码

• 可以使用 --sw 参数和代码来调整随机风格对图像的影响

• 可以通过使用多个代码混合风格，以及将图像与代码结合使用

注意： 目前 sref 代码仅适用于悠船内部库中的随机风格。你不能基于上传的图像创建 sref 代码。

3.7 风格版本（--sv）

风格参考功能有多个版本，使用 --sv 参数在它们之间选择。每个版本提供解释和应用风格参考的独特方式。

v6、v6.1、Niji 6 中的风格版本：

V7 中使用图像时的风格版本（共六个）：

Niji 7 中的风格版本：

注意： --sref random 和 --sref 风格code 仅与 --sv 4 和 --sv 6 兼容。

V8/V8.1 二次操作中的 --sv 行为： 基于 V8/V8.1 referJob 的派生任务（变体/各类 upscale/虚拟放大/remix 等）在引擎层会以 V7 模型版本执行；--sv 取值在 V7/V8 之间不重叠（如 V8 默认 --sv 6），因此 --sv 会被自动忽略（同时写一行 warn 日志），不会因取值不兼容而 4xx。如果需要明确指定 sv 版本，请在文生图阶段而不是二次操作阶段使用。

3.8 为各个风格参考分配不同权重

你可以为多个风格参考分配不同的权重比例：

提示词 --sref URL1::2 URL2::1 URL3::1

上面的例子中，URL1 的风格影响力是 URL2 和 URL3 的两倍。

3.9 兼容性说明

• 需要将文本提示与风格参考结合使用

• 图像文件格式：.png、.gif、.webp、.jpg、.jpeg

• 可以与悠船 v6、v6.1、Niji 6 一起使用；与 v7、v8.1、Niji 7 也兼容

• 可以与角色参考（--cref）和图像提示词同时使用

4.1 什么是万物引用

万物引用允许你将参考图像中的角色、物体、车辆或非人类生物放入你的悠船创作中。它是角色参考的升级版本，且仅支持 v7 模型。

注意： 万物引用与仍使用 V6.1 的功能（如局部重绘/延展/扩图）不兼容。

4.2 使用方式

在提示词末尾添加 --oref 参数，然后粘贴图像 URL。万物引用只能使用一张图像。

一只手拿魔法棒的小鸭子 --oref http://image.png

4.3 最佳实践

• 文本提示的重要性：将万物引用与清晰的文本提示结合使用。文本对于传达参考图像之外的完整场景和额外细节同样重要

• 强化风格：如果你希望图像使用与参考不同的风格，在提示的开头和结尾都提及你想要的风格。例如："插图风格的一个短灰发年轻女性，漫画艺术风格。"也可以考虑使用风格参考（--sref）并降低万物引用权重

• 多个角色：虽然只能使用一张图像作为万物引用，但你可以尝试使用包含多个角色/人物的图像，并在提示中描述它们

• 注意细节：特定的细节（如雀斑或服装上的标志）可能无法完全匹配参考

• 考虑其他参数：如果你使用高风格化值（--stylize）或 --exp 值，可能还需要使用更高的万物引用权重，因为这些参数会相互竞争影响力

4.4 万物引用权重（--ow）

万物引用权重参数 --ow 允许你控制参考图像中有多少细节出现在新图像中：

• 取值范围：1 - 1000

• 默认值：--ow 100

• 建议保持在 400 以下（除非使用非常高的风格化值），否则结果可能不可预测

4.5 兼容性说明

• 需要将文本提示与万物引用结合使用

• 图像文件格式：.png、.gif、.webp、.jpg、.jpeg

• 仅支持悠船 v7

• 可以与风格参考（--sref）和图像提示词同时使用

• 与局部重绘/延展/扩图不兼容（这些功能仍使用 V6.1 引擎）

5.1 多提示词功能

多提示词功能允许用户将不同概念进行独立控制与组合。通过双冒号 :: 分隔不同提示词，系统会分别处理每个提示词，再将结果进行智能融合。

示例：

• 普通提示词：space ship → 生成科幻太空船

• 多提示词：space:: ship → 分别处理"太空"和"船"的概念，可能生成在太空中航行的船只

格式要求：

• 双冒号左侧不能有空格

• 双冒号右侧需要添加一个空格

• 所有参数仍应放在提示词的最后

注意： 多提示词功能暂不支持版本 7 模型。支持的版本包括：v1-v6、v6.1、Niji 4-6。

5.2 权重控制

在双冒号 :: 后直接添加数字表示权重值：

space::2 ship

表示"太空"的重要性是"船"的两倍。

权重规则：

• V1-V3 版本：仅支持整数权重

• V4-V6、Niji 4-6、6.1 版本：支持小数权重

• 默认权重：1

5.3 负面提示词控制

通过设置负权重，可以排除不希望出现在图像中的元素：

• 有效示例：still life painting:: fruit::-0.5（总权重 = 1 + (-0.5) = 0.5，正数，有效）

• 无效示例：still life painting:: fruit::-2（总权重 = 1 + (-2) = -1，负数，无效）

重要原则：所有权重之和必须为正数。

5.4 --no 参数（否定参数）

--no 参数等同于设置 -0.5 的权重：

vibrant tulip fields --no red

等效于：

vibrant tulip fields:: red::-0.5

使用场景：

• 排除特定对象：--no 水果,树木

• 避免特定风格：--no 卡通,抽象

• 控制图像特征：--no 阴影,高光

6.1 什么是风格化参数

风格化参数用于控制图像中的艺术风格程度。它决定了悠船在生成图像时加入多少"美学优化"。

• 取值范围：0 - 1000

• 低值：更忠实于提示词，艺术修饰少

• 高值：更具艺术感和美感，但可能偏离提示词原意

6.2 与图片引用的关系

当你同时使用图片引用（如 --oref、--sref）和高 --stylize 值时，两者会相互竞争影响力。如果需要保持图片引用的准确性，建议适当降低风格化值，或提高对应引用的权重。

7.1 什么是 Moodboard

Moodboard 是悠船开放平台的灵感收集板功能，允许你创建和管理图片集合，用于创意项目的视觉参考和灵感收集。在生成图像时，你可以引用一个 Moodboard 作为整体风格参考。

7.2 Moodboard 与图片引用的配合

你可以将万物引用与 Moodboard、风格化和风格参考结合使用，创造丰富的视觉效果。

7.3 API 接口

创建 Moodboard：

import requests

url = "https://ali.youchuan.cn/v1/tob/moodboard"
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}
data = {
    "name": "我的创意收集",
    "description": "收集各种风景图片",
    "images": ["https://example.com/image1.jpg", "https://example.com/image2.jpg"]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

更新 Moodboard：

moodboard_id = "12345"
url = "https://ali.youchuan.cn/v1/tob/moodboard/" + moodboard_id
data = {
    "name": "更新后的创意收集",
    "description": "更新后的描述",
    "images": ["https://example.com/new-image1.jpg", "https://example.com/new-image2.jpg"]
}
response = requests.put(url, headers=headers, json=data)

获取 Moodboard 列表：

url = "https://ali.youchuan.cn/v1/tob/moodboards"
params = {"pageNo": 1, "pageSize": 10}
response = requests.get(url, headers=headers, params=params)

7.4 兼容性

Moodboard（个性化）支持 v6、v6.1、Niji 7、v7 和 v8.1 版本。Niji 6 不支持。

9.1 V6/V6.1 复合引用（图像提示 + 角色参考 + 风格参考 + Moodboard）

在 V6/V6.1 中，你可以同时使用：图像提示词、角色参考、风格参考（含多图加权）、Moodboard（个性化配置），再配合图像权重、角色权重、风格权重、风格版本等参数实现精细控制。

提示词结构：

[图像提示URL] [文本描述] --cref [角色图URL] --cw [角色权重] --sref [风格图URL1]::[权重1] [风格图URL2]::[权重2] --sw [风格权重] --sv [风格版本] --iw [图像权重] --p [Moodboard ID] --s [风格化值] --no [排除元素] --ar [宽高比]

完整实例：

https://img.example.com/landscape-ref.jpg 一个蓝色短发的少女站在樱花树下微笑，春天的午后阳光温暖 --cref https://img.example.com/character-blue-hair.jpg --cw 80 --sref https://img.example.com/ghibli-style.jpg::2 https://img.example.com/watercolor-texture.jpg::1 --sw 300 --sv 4 --iw 1.5 --p abc123moodboard --s 200 --no 文字,logo,暗色 --ar 3:2 --v 6.1

逐段解读：

对应 API 调用：

import requests

# 前置步骤：先创建 Moodboard 获取 ID
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}
moodboard_resp = requests.post(
    "https://ali.youchuan.cn/v1/tob/moodboard",
    headers=headers,
    json={
        "name": "春日暖色灵感板",
        "description": "温暖色调的春日参考图集",
        "images": [
            "https://img.example.com/spring1.jpg",
            "https://img.example.com/spring2.jpg",
            "https://img.example.com/spring3.jpg"
        ]
    }
)
moodboard_id = moodboard_resp.json()["id"]  # 假设返回 "abc123moodboard"

# 复合引用调用
# 注意：text 字段是一整条连续字符串，包含图片URL、文本描述和所有参数
url = "https://ali.youchuan.cn/v1/tob/diffusion"
data = {
    "text": "https://img.example.com/landscape-ref.jpg 一个蓝色短发的少女站在樱花树下微笑，春天的午后阳光温暖 --cref https://img.example.com/character-blue-hair.jpg --cw 80 --sref https://img.example.com/ghibli-style.jpg::2 https://img.example.com/watercolor-texture.jpg::1 --sw 300 --sv 4 --iw 1.5 --p abc123moodboard --s 200 --no 文字,logo,暗色 --ar 3:2 --v 6.1",
    "callback": "https://your-server.com/callback"
}
# 注：上面 --p 后面的 abc123moodboard 要替换为你实际创建 Moodboard 时返回的 ID
response = requests.post(url, headers=headers, json=data)
print(response.json())

关键说明： text 字段的值是一整条纯文本字符串，图片 URL、文本描述和所有 --参数 之间用空格分隔，不要有多余的引号或换行。发送到 API 时，JSON 中的 text 值长这样：

https://img.example.com/landscape-ref.jpg 一个蓝色短发的少女站在樱花树下微笑，春天的午后阳光温暖 --cref https://img.example.com/character-blue-hair.jpg --cw 80 --sref https://img.example.com/ghibli-style.jpg::2 https://img.example.com/watercolor-texture.jpg::1 --sw 300 --sv 4 --iw 1.5 --p abc123moodboard --s 200 --no 文字,logo,暗色 --ar 3:2 --v 6.1

9.2 V7 复合引用（图像提示 + 万物引用 + 风格参考 + Moodboard）

在 V7 中，角色参考（--cref）被万物引用（--oref）替代。你可以同时使用：图像提示词、万物引用、风格参考（含多图加权）、Moodboard，配合各自的权重参数。

提示词结构：

[图像提示URL] [文本描述] --oref [物体/角色图URL] --ow [万物引用权重] --sref [风格图URL1]::[权重1] [风格图URL2]::[权重2] --sw [风格权重] --sv [风格版本] --iw [图像权重] --p [Moodboard ID] --s [风格化值] --no [排除元素] --ar [宽高比]

完整实例：

https://img.example.com/forest-bg.jpg 插图风格的一只穿红色斗篷的狐狸骑士站在古老城堡前，史诗奇幻冒险，电影级光影 --oref https://img.example.com/fox-knight-character.jpg --ow 200 --sref https://img.example.com/epic-fantasy-art.jpg::3 https://img.example.com/oil-painting-texture.jpg::1 --sw 400 --sv 6 --iw 1 --p def456moodboard --s 350 --no 现代元素,文字,模糊 --ar 16:9 --v 7

逐段解读：

对应 API 调用：

data = {
    "text": "https://img.example.com/forest-bg.jpg 插图风格的一只穿红色斗篷的狐狸骑士站在古老城堡前，史诗奇幻冒险，电影级光影 --oref https://img.example.com/fox-knight-character.jpg --ow 200 --sref https://img.example.com/epic-fantasy-art.jpg::3 https://img.example.com/oil-painting-texture.jpg::1 --sw 400 --sv 6 --iw 1 --p def456moodboard --s 350 --no 现代元素,文字,模糊 --ar 16:9 --v 7",
    "callback": "https://your-server.com/callback"
}
response = requests.post(url, headers=headers, json=data)

9.3 V8.1 复合引用（图像提示 + 风格参考 + Moodboard + 原生高清）

V8.1 新增了原生 2K 高清模式（--hd）和更高的质量参数（--q 4），兼容 V7 的 sref 和 Moodboard。但注意：V8.1 不支持万物引用（--oref）也不支持角色参考（--cref），图片引用的控制主要通过图像提示词 + 风格参考来实现。

提示词结构：

[图像提示URL] [文本描述] --sref [风格图URL1]::[权重1] [风格图URL2]::[权重2] --sw [风格权重] --iw [图像权重] --p [Moodboard ID] --s [风格化值] --no [排除元素] --ar [宽高比] --hd --q 4

完整实例：

https://img.example.com/product-angle.jpg 一双精致的白色运动鞋放在大理石桌面上，旁边有一株绿植，极简杂志广告摄影 --sref https://img.example.com/minimalist-ad.jpg::2 https://img.example.com/soft-light-photo.jpg::1 --sw 250 --iw 2 --p ghi789moodboard --s 150 --no 人物,文字,杂乱背景 --ar 4:3 --hd --q 4 --v 8.1

逐段解读：

关键差异点（V8.1 vs V7）：

9.4 参数优先级与权重竞争关系图

当多种引用同时存在时，各参数之间存在"竞争"关系。以下是影响力分配的逻辑：

最终图像 = f(文本提示, 图像提示×iw, 角色/万物引用×cw/ow, 风格参考×sw, Moodboard, 风格化×s)

调参建议：

核心原则： 各权重参数不是独立生效，而是共同竞争最终图像的"注意力"。当一个参数值过高时，其他参数的影响会被压缩。建议从默认值开始，每次只调一个参数，逐步找到最佳平衡。

10.1 可以同时使用的组合

• 图像提示词 + 风格参考（--sref）

• 图像提示词 + 角色参考（--cref）——仅限 v6、v6.1、Niji 6

• 图像提示词 + 万物引用（--oref）——仅限 v7

• 角色参考 + 风格参考——仅限 v6、v6.1、Niji 6

• 万物引用 + 风格参考——仅限 v7

• 万物引用 + Moodboard——仅限 v7

• 万物引用 + 风格化（--stylize）——注意权重竞争

10.2 典型工作流示例

场景一：保持角色一致性（v6、v6.1、Niji 6）

一个蓝发戴金色眼镜的男人在海边跑步 --cref 角色图片Url --cw 80

场景二：统一画风（v6、v6.1、Niji 6、Niji 7、v7、v8.1）

一只猫坐在窗台上 --sref 风格图片Url --sw 200

场景三：将物体放入新场景（仅 v7）

插图风格的一只穿红色外套的小熊在森林中探险，卡通动画风格 --oref 小熊图片Url --ow 150 --v 7

场景四：混合多张图片的视觉元素

图片Url1 图片Url2 图片Url3 梦幻般的风景画 --iw 2

Q1：图片链接格式有什么要求？

图片 URL 必须是公网可直接访问的链接，文件后缀为 .png、.gif、.webp、.jpg 或 .jpeg。不支持需要登录或鉴权才能访问的图片地址。

Q2：为什么我的角色参考在 V7/V8.1 中不生效？

V7 和 V8.1 都不支持 --cref 参数。如果使用 V7，请改用万物引用 --oref，它是角色参考的升级版本。如果使用 V8.1，目前没有专门的角色/物体引用参数，需要通过图像提示词（--iw 提高权重）配合精准文本描述来实现类似效果。

Q3：风格参考和图像提示词有什么区别？

• 图像提示词：影响内容、构图和色彩，悠船会参考图片中的具体对象和场景

• 风格参考：只影响风格（色彩、媒介、纹理、光照等），不会复制图片中的对象或人物

Q4：多个参数的权重如何平衡？

当同时使用 --iw、--sw、--ow、--stylize 等参数时，它们会相互竞争影响力。建议：

• 如果某个引用效果不明显，提高其权重

• 如果希望文本描述更重要，降低图片引用的权重

• 如果使用高 --stylize 值，同时提高图片引用的权重

Q5：--sref random 的代码在不同版本之间通用吗？

不完全通用。同一个 sref 代码在 V6.1 和 V7 中会产生不同的风格效果。且 --sref random 和 --sref 风格code 仅与 --sv 4 和 --sv 6 兼容。