NovelAI 原生格式 API

本站提供兼容 NovelAI 原生格式的接口，适用于支持 NovelAI（简称 NAI）协议的第三方客户端、小手机、酒馆插件和自行实现的程序。

原生接口沿用 NovelAI 风格的请求体和响应格式。

本文说明本站提供的端点、鉴权方式、响应格式和使用限制，不列出原生请求体参数。使用第三方客户端时，请求体由客户端生成；自行编程时，需按照 NovelAI 公开的原生接口资料构造请求体。

协议无关的模型、尺寸、提示词、输出格式和费用限制见通用生成规则。

鉴权

所有原生兼容接口都使用本站 API Key：

Authorization: Bearer 你在本站生成的 API Key
Content-Type: application/json

Bearer 前缀区分大小写。本文以 https://api.taleapi.asia/v1 为例，也可以从线路与接口选择其他线路。

非流式生图

POST https://api.taleapi.asia/v1/ai/generate-image

请求体按 NovelAI 原生格式提交。成功时返回包含最终 PNG 图片的 ZIP。

自行编程调用时，请按照 NovelAI 原生接口格式构造请求体。使用第三方 NovelAI 客户端时，请求体通常由客户端自动生成，无需手动填写。

MessagePack 流式生图

POST https://api.taleapi.asia/v1/ai/generate-image-stream

请求体按 NovelAI 原生格式提交，响应使用 NovelAI 原生 MessagePack 事件格式。

MessagePack 是一种二进制数据序列化格式，客户端需按该格式解析事件。此接口不提供中间预览：等待图片生成完成后返回最终图片事件，随后结束响应流。

独立 Vibe Encode

Vibe Transfer（氛围转移）使用参考图影响生成画面的风格与氛围。Encode（编码）将参考图转换为可供后续生图复用的数据；只有需要单独准备这类数据的客户端或程序才需调用本端点。

POST https://api.taleapi.asia/v1/ai/encode-vibe

使用相同的 Bearer 鉴权，按 NovelAI 原生 Encode 格式提交 JSON。支持 V4 Full、V4.5 Full / Curated，不支持 V5。此接口只编码参考图，不生成图片；每次成功编码消耗 2 Anlas（NovelAI 的点数单位），不收生图基础费用。

成功响应为原始编码二进制，Content-Type: application/binary，不是 JSON、PNG 或 ZIP。客户端应保存二进制内容，并按原生协议在后续生图请求中复用。

固定订阅兼容接口

GET https://api.taleapi.asia/v1/user/subscription

该接口使用相同的 Authorization: Bearer 请求头鉴权，用于兼容会查询订阅信息的 NovelAI 客户端。

它是固定占位接口，不会查询或返回调用方的真实套餐、余额或账号状态。客户端不得将其响应作为真实订阅或计费依据。

第三方客户端配置

支持 NovelAI 原生协议的客户端通常只需填写：

• URL：例如 https://api.taleapi.asia/v1
• Key：你在本站生成的 sk-... Key

不同客户端可能自动拼接 /ai/generate-image 或 /ai/generate-image-stream，应按客户端自己的 Base URL 说明填写。

模型能力与费用

支持 V4 Full、V4.5 Full / Curated、V5 Full / Curated，完整 ID 见模型表。每次生成一张图片，最多 6 个角色，步数为 1～50。最终宽高须各为 64～4096 内的 64 倍数，总像素不超过 3145728。请求尺寸会调整为符合限制的尺寸，具体见尺寸处理；图生图原图、局部重绘原图和遮罩必须匹配最终尺寸。

Vibe Transfer（氛围转移）支持 V4 / V4.5，最多 4 张参考图；Precise Reference（精准参考，用图片指定角色或风格）仅支持 V4.5，最多 4 张。二者不能同时使用。V5 不支持这两种参考图功能、Variety+（增加生成多样性的选项）或 k_dpm_2_ancestral 采样器。提示词语言要求见提示词限制。客户端显示某个选项不代表所选模型支持它。

原生格式接口不提供单次费用上限设置。 生成费用包含基础费用和实际消耗的 Anlas（NovelAI 的点数单位），0 Anlas 仍需支付基础费用。提交前应确认接受所选模型和参数对应的费用；独立 Encode 单独收取编码费用，不收生图基础费用。金额以主站模型广场的模型、分组定价和使用日志为准，换算方式见费用说明。

错误处理

客户端应同时检查 HTTP 状态码和响应 Content-Type。错误响应的 JSON 结构可能不同，也可能包含 OpenAI 风格的 error.code / error.message；不能假定所有错误都是 NovelAI 原生格式，也不能把失败响应当 ZIP 或 MessagePack 解码。

参数错误通常返回 HTTP 400；403 NAI5_NOT_ALLOWED / ANLAS_NOT_ALLOWED 表示请求权限不足，503 NAI5_UNAVAILABLE / NO_PAID_CREDIT 表示当前服务资源不可用。完整错误类别可参考 OpenAI 错误说明，并以实际响应结构为准。