主题
NovelAI 绘图模型：客户端使用说明
本文说明如何使用本站的 NovelAI 绘图模型。建议优先使用 TaleNai 在线生图；希望在聊天中通过自然语言生成图片时，可以使用 NovelAI MCP；需要第三方 NAI 客户端时，次优先使用 NovelAI 原生格式；客户端不支持原生协议时，再使用 OpenAI 兼容格式。
本页按工具分别介绍配置方法；“发送绘图请求”和“常用参数”仅适用于 OpenAI Chat 客户端。选择模型时可查阅模型能力表，生成前应了解基础费用与点数费用。自行编程调用请阅读 API 总览。
TaleNai 在线生图
TaleNai 在线生图 是本站提供的在线 NovelAI 生图工具，推荐优先使用。无需安装或配置第三方客户端，输入本站 API Key 后即可开始生图。
网页提供下列绘图功能，以及当前浏览器会话内的生成历史记录。API Key 由网页直接用于请求；只有主动勾选“记住密钥”时才会写入当前浏览器的本地存储。
网页可分别描述多个角色、基于原图重绘整张图（图生图）、修改指定区域（局部重绘），并设置尺寸与生成迭代步数。图生图与局部重绘不能同时启用。REFERENCE（参考图） 区域提供两种不能同时启用的模式：
- 氛围迁移（Vibe Transfer）：参考图片的风格与氛围，可调整参考强度和信息提取程度。图片编码为可复用数据后，可使用缓存避免重复编码，缓存命中时不额外收取编码费；切换模型或缓存失效时可能需要重新上传。
- 精准参考（Precise Reference）：参考图片中的角色或风格，可选择参考类型，调整强度和保真度。
NovelAI MCP
NovelAI MCP 使用 MCP（聊天客户端调用外部工具的协议）提供文生图工具。客户端需支持 Streamable HTTP 远程连接和自定义请求头。配置后，可以在聊天中描述画面需求，由聊天模型调用工具；它不提供上传原图修改或参考图功能。
MCP 端点为线路网址加 /mcp，请求头中填写 Authorization: Bearer 你的本站APIKey。RikkaHub 和 Kelivo 已通过可用性测试；RikkaHub 的配置步骤和截图见 NovelAI MCP 使用教程。
NovelAI 原生格式
TaleNai 不满足使用场景时，建议次优先使用 NovelAI 原生格式。市面上常见的 NAI 第三方客户端，以及小手机、酒馆插件等支持 NovelAI 原生协议的工具，都可以通过此方式接入。
这类客户端可以直接使用本站接口，无需转换为 OpenAI 兼容格式。配置时填写带 /v1 的线路地址和你在本站生成的 API Key：
- URL：例如
https://api.taleapi.asia/v1 - Key：你在本站生成的
sk-...Key
具体端点和响应格式请参考 NovelAI 原生 API 及客户端自身的使用说明。
OpenAI 兼容格式
适用于不支持 NovelAI 原生协议的普通 OpenAI 兼容客户端。客户端满足以下任意一种情况即可使用：
- 支持自定义用户提示词，并能显示 Markdown Data URI 图片（图片内容直接嵌入回复，不是外部链接）。
- 支持调用 OpenAI Images 的
/v1/images/generations端点并显示返回的图片。
通过 Chat Completions 聊天接口调用时，发送纯文本即可使用基础文生图。需要扩展参数时，客户端必须能原样发送 JSON（用字段名和值描述参数的文本格式）。普通聊天图片附件不能用于此接口；图生图和局部重绘需按专用参数传入图片，具体见图生图和局部重绘。
建议使用 JSON
直接发送纯文本时，服务端会把整条消息作为正向提示词，但只能使用基础文生图能力，并附加格式警告。要设置负向提示词、尺寸、采样器、多角色、图生图、局部重绘或参考图，必须发送完整的 JSON 对象。
OpenAI 兼容客户端配置
在客户端中新增一个 OpenAI 兼容服务，并填写：
- Base URL：从线路与接口中选择一个线路地址，例如
https://api.taleapi.asia - API Key：你在本站生成的
sk-...Key - 模型名称：例如
nai-diffusion-4-5-full
如果客户端无法连接，可以尝试在 Base URL 末尾加上 /v1。
发送绘图请求
以下操作仅适用于把 NovelAI 配置为聊天模型的 OpenAI Chat 客户端，不适用于 MCP 或原生客户端。
将上下文数量设置为 1
每次绘图只读取最后一条用户消息，不会结合之前的对话修改画面。建议将上下文数量设为 1，关闭多轮上下文，并在一条新消息中写全本次绘图参数。
在客户端的消息输入框中发送一个合法的 JSON 对象。以下内容可以直接作为基础模板：
json
{
"prompt": "1girl, solo, young, cat ear, masterpiece, best quality",
"negative_prompt": "lowres, bad anatomy, bad hands, text, watermark",
"size": [1216, 832],
"steps": 28,
"scale": 5,
"sampler": "k_euler_ancestral"
}发送后，服务端会在助手回复中返回 Markdown 格式的图片。客户端支持 Markdown 图片渲染时，图片会直接显示在对话中。
常用参数
下表字段填写在 OpenAI Chat 客户端发送的 JSON 中；其他接入方式不要直接照搬。
| 字段 | 是否必填 | 说明 |
|---|---|---|
prompt | 是 | 描述希望出现的画面，语言规则见提示词限制。 |
negative_prompt | 否 | 不希望图片中出现的内容，语言规则同上。 |
size | 否 | 图片尺寸，必须是 [宽, 高] 整数数组。 |
steps | 否 | 生成迭代次数，默认 28，范围见生成数量与步数。 |
scale | 否 | 提示词引导强度，常用值为 5。 |
sampler | 否 | 采样器，默认 k_euler_ancestral。 |
seed | 否 | 随机种子；不填写时随机生成。 |
常用最终尺寸及尺寸归一化行为见通用生成规则的尺寸处理章节。Chat 自定义协议中的 size 必须使用 [宽, 高] 整数数组；"832x1216"、"portrait" 等字符串写法无效。
各模型提示词语言、校验和清洗规则见提示词限制。
常见问题
通过 OpenAI Chat 调用时返回 JSON 格式错误
使用本站 Chat 自定义参数时，确认发送内容满足以下条件：
- 最外层使用
{}，是一个 JSON 对象。 - 字段名和字符串使用英文双引号
"。 - 最后一个字段后没有多余逗号。
- 没有在 JSON 前后添加解释文字或 Markdown 代码围栏。
OpenAI Chat 返回内容，但客户端没有显示图片
该客户端可能不支持 Markdown Data URI 图片渲染。请更换支持该格式图片渲染的 OpenAI 兼容客户端，或使用 OpenAI 兼容 API中的响应解析方式自行保存图片。
客户端使用 OpenAI Images API
/v1/images/generations 支持基础文生图字段。如果客户端把该模型配置为图片生成模型，可使用 prompt、n: 1、size、response_format: "b64_json" 和 stream。
/v1/images/edits 支持上传单张原图执行整图图生图。该端点不是局部重绘接口。
Images generations 不支持负向提示词、采样器、步数、多角色、图生图和局部重绘。如果当前客户端只支持 OpenAI 兼容格式，可以将模型配置为聊天模型，并通过 Chat 自定义参数使用这些能力；支持 NovelAI 原生格式的客户端则可以使用对应的原生功能。
需要多角色、图生图或局部重绘
支持 NovelAI 原生格式的客户端按自身说明操作。使用 OpenAI Chat 时，分别查阅多角色、图生图和局部重绘参数。
提示 completion_tokens 超过 max_tokens 上限
通过 OpenAI Chat 生图遇到 402 MAX_TOKENS_EXCEEDED 时，表示所需 Anlas（NovelAI 点数）超过本次预算，不是回复文字太长。客户端的“最大输出 Token”设置在这里用作额外点数预算，不包含基础费用。确认接受费用后调整或移除该设置，也可降低尺寸、步数。通过 Chat 使用氛围转移参考图时，该预算不起限制作用；参数换算及例外条件见 Chat 点数费用上限。
提示服务缺少 V5 资源或可用点数
503 NAI5_UNAVAILABLE / NO_PAID_CREDIT 表示服务当前缺少可用资源，不等于钱包余额不足；稍后重试或联系管理员。
仍无法解决问题
遇到看不懂或无法解决的报错、按照文档仍无法正常使用，或需要了解客户端配置和接口调用方法时，可以加入 QQ 讨论群 901635977 询问。反馈问题时，请尽量提供使用的客户端、接口格式、请求参数和完整错误信息，以便定位问题。相关反馈也会用于发现接口兼容性和文档说明中仍需改进的部分。