NovelAI 官方格式 - 多角色/氛围迁移/角色参考

图片生成工具站

NovelAI 官方格式

支持 NovelAI V4/V4.5 模型的高级功能：

✅ NovelAI 官方格式 - 使用 /ai/generate-image 端点，兼容官方 API
✅ Opal 兼容格式 - 实测兼容 /v1/chat/completions，从 choices[0].message.content 提取图片 URL
✅ 请求格式切换 - 生成图片和酒馆正则均可在 NovelAI / Opal 两种格式间切换
✅ 多角色提示词 - 通过 character_prompts 参数支持最多 6 个独立角色
✅ Vibe Transfer - 使用 vibe_transfer 数组传递风格参考图
✅ Character Reference - 使用 director_reference 保持角色一致性
✅ 正则生成 - 可生成酒馆正则配置，支持 image###提示词### 触发

💡 请求格式说明：

通用结构：{ input, model, action: "generate", parameters: { ... } }
NovelAI：POST /ai/generate-image，响应通常为 zip 图片流
Opal：POST /v1/chat/completions，响应 JSON 包含 choices[0].message.content 图片 URL

⚠️ 重要提示：

NovelAI 模型默认偏向生成女性，必须明确写性别标签
男性角色请使用：1boy, 1man, male focus
女性角色请使用：1girl, 1woman, female focus

API 配置（必填）

API 地址填写到域名即可（不要带 /v1、/ai/generate-image 或 /generate）

API Key

模型名称可直接输入任意模型名称，也可从建议列表中选择。

请求格式

基础提示词（Base Prompt）

质量提示词（不要在这里写性别/人物特征）只写画质相关的词，人物特征请写在场景或角色提示词中

场景/人物提示词（⚠️ 必须指定性别） 重要：必须使用 1boy/1man 或 1girl/1woman 明确指定性别，否则可能默认生成女性

负面提示词

多角色提示词（Character Prompts） V4+

💡 每个角色可以有独立的提示词。使用 | 分隔基础提示词和角色提示词。

动作标签可使用前缀：source#（施动）、target#（受动）、mutual#（互动）

AI’s Choice（自动位置）关闭后可为每个角色选择 A1–E5 位置

Vibe Transfer（氛围迁移） V4+

💡 使用 NovelAI 官方格式时，Vibe Transfer 通过 vibe_transfer 参数原生支持。

📌 使用 OpenAI 兼容格式时，是否生效取决于 API 是否实现参考图字段。

Character Reference（角色参考） V4.5

💡 使用 NovelAI 官方格式时，Character Reference 通过 director_reference 参数原生支持。

📌 使用 OpenAI 兼容格式时，是否生效取决于 API 是否实现角色参考字段。

点击上传角色参考图

Style Aware（风格感知）启用后会迁移角色的绘画风格细节

Fidelity（保真度）: 1.0 0 = 更灵活的风格，1 = 更高的细节保真

图片参数

图片尺寸

采样步数

CFG Scale

采样器

随机种子

生成结果

提示词预览

正则配置结果

生成 URL

HTML 代码

酒馆正则 JSON

使用说明

请求格式

• NovelAI 官方格式调用 /ai/generate-image，适合官方 NovelAI API 或返回 zip 图片流的中转。

• Opal 兼容格式调用 /v1/chat/completions，适合实测返回 choices[0].message.content 图片 URL 的 Opal / New API 网关。

• NovelAI 格式以 { input: "提示词", model: "模型名", action: "generate", parameters: { ... } } 为基础。

• Opal 模式使用 OpenAI Chat Completions 请求体，参数通过 Parameter{...} 附加在提示词末尾。

• 所有参数（width/height/steps/scale/sampler/seed 等）放在 parameters 对象中

• 多角色通过 parameters.character_prompts 数组传递

• Vibe Transfer 通过 parameters.vibe_transfer 数组传递

• 点击"预览 NAI 请求体"可查看将要发送的完整 JSON

多角色提示词

• 点击"添加角色"为每个角色创建独立提示词

• 基础提示词中写场景和人数（如 2girls, outdoors）

• 角色提示词中写每个角色的外观（如 girl, purple hair, smile）

• 使用 source#hug、target#hug 等动作标签控制交互

Vibe Transfer

• 上传参考图片，AI 会学习其风格和氛围

• Reference Strength：控制风格迁移强度

• Information Extracted：控制提取的信息量

Character Reference

• 上传角色参考图，AI 会保持角色一致性

• 建议使用全身立绘、中性姿势、简单背景

• Style Aware：启用后会迁移绘画风格

• Fidelity：控制细节保真度

正则生成

• 点击"生成正则配置"可生成酒馆用的正则 JSON

• 在酒馆中使用 image###提示词### 触发图片生成

• 下载 JSON 文件后在酒馆正则设置中导入即可