NovelAI 的官方 API 基址是 https://api.novelai.net,官方 API 文档在 api.novelai.net/docs/。需要说明的是,NovelAI 一共有三套官方 API——主 API、图像生成 API、文本生成 API,分处三个域名;它并非"开放平台"式服务,第三方集成必须使用用户自己的 Persistent API Token,且需要有效订阅。本文整理三个官方端点、文档入口、认证方式与常见误区。 NovelAI 的三个官方 API 端点与文档入口
NovelAI 官方文档(text.novelai.net/docs)原文写明:"Currently, you have access to three APIs"——官方在改版时把「主 API(登录、订阅、故事保存等)」与「生成 API」做了拆分,因此现在共有三个官方端点:
| | |
|---|
| https://api.novelai.net
文档:https://api.novelai.net/docs/ | 账号注册与登录、订阅管理、故事与对象保存、Token 创建 |
| https://image.novelai.net
文档:https://image.novelai.net/docs/index.html | |
| https://text.novelai.net
文档:https://text.novelai.net/docs/index.html | |
三份文档均为可直接访问的 Swagger UI 页面,无需登录即可查看接口定义。主 API 中与生成相关的路由集中在 /ai/ 下,包括:
- POST /ai/generate —— 文本生成
- POST /ai/generate-stream —— 流式文本生成
- POST /ai/generate-image —— 图像生成
- POST /ai/annotate-image —— 图像打标
- GET /ai/generate-image/suggest-tags —— 生成建议标签
- POST /ai/generate-voice —— 语音生成(旧的 GET 端点已废弃)
- POST /ai/classify —— 序列分类
最关键的一条官方说明(来自 api.novelai.net/docs 页首原文):"The Primary API describes actions that our Frontend makes against the NovelAI backend. In general, third-party NovelAI API users should not engage with the Primary API beyond the /ai/ routes."——即第三方只应使用 /ai/ 下的路由,不要碰账号、订阅等其他接口。
获取 Token 与调用步骤
NovelAI 的 API 不是"申请一个平台 Key 就通用",而是必须使用用户自己的 Persistent API Token。官方原文:"you need to request a user's Persistent API token for integration and use it in the Authorization header"。调用流程如下:
- 在 novelai.net/register 注册账号并完成邮箱验证。
- 购买任一订阅档位——API 调用依赖订阅权益,免费试用期无法作为正式 API 使用。
- 创建 Persistent API Token(主 API 提供 POST /user/create-persistent-token 端点)。
- 在每次请求的 Authorization 请求头中携带该 Token(HTTP Bearer 认证)。
- 按文档向 /ai/ 下的对应端点发起请求;图像与文本生成也可改用专用的 image / text 端点。
安全提醒加粗记牢:官方明确指出——"For security reasons, storing user credentials in plaintext is strongly discouraged",并进一步说明凭据"provide the encryption key for a user's stories, improper handling can compromise user data"。即用户的账号凭据同时是其故事内容的加密密钥,一旦泄露,泄露的不只是调用额度。因此不要把自己的账号密码交给任何第三方代理服务代管。
订阅价格与额度对照
API 与网页端共用同一套订阅权益,价格核查自官方文档(docs.novelai.net/en/subscription),单位美元:
| | |
|---|
| | 需邮箱验证账号:30 次图像生成(≤1024×1024)、50 次文本生成、100 次语音生成 |
| | 无限文本与语音生成;每月 1000 Subscription Anlas |
| | Tablet 全部权益,另提供更大的上下文长度;每月 1000 Anlas |
| | Tablet/Scroll 全部权益;最大上下文 28,672 tokens;部分图像生成免 Anlas;每月 10,000 Anlas |
订阅周期的官方说明:除免费试用外,订阅在付款后整 30 天续订;取消订阅后,档位权益会保留至已付周期结束。
Anlas 计费与使用规则
Anlas 是 NovelAI 的用量货币,理解两类 Anlas 的区别是控制成本的关键:
- Subscription Anlas(订阅额度):随订阅发放,按「已消耗数量」在每次续订时补足——例如 Tablet 档每月 1000,若你只用了 500,续订时补 500,而非补满 1000。因此官方建议"续订前尽量把剩余额度用掉"。
- Paid Anlas(付费额度):在订阅之外单独购买,只在 Subscription Anlas 用尽后才被消耗,且不参与每月补足计算。
- 重要变化:官方公告指出,自 NovelAI Diffusion V5 发布满 31 天后,订阅结束时未使用的 Subscription Anlas 将清零;取消订阅后也无法再单独购买 Anlas。
- 当前需消耗 Anlas 的主要场景是图像生成;文本与语音生成在订阅期内不限量。
API 使用注意事项与风险提示
- 官方 API 只有三个域:api.novelai.net(主)、image.novelai.net(图像)、text.novelai.net(文本)。网上流传的其他"NovelAI API 中转地址"均为第三方,非同官方。
- 不要明文交出账号密码:官方强烈不建议明文保存用户凭据,且账号凭据同时是故事内容的加密密钥,泄露后果超出额度损失。优先使用 Persistent API Token。
- 第三方只应用 /ai/ 路由:官方明确要求第三方不要触碰主 API 中 /ai/ 以外的接口,否则可能违反服务条款。
- 必须遵守服务条款:官方原文要求 "All API users must adhere to the NovelAI Terms of Service"(novelai.net/terms)。
- API 不是免费产品:调用依赖有效订阅,免费试用档不能作为正式 API 长期使用。
- 注意 Anlas 清零规则:订阅结束或取消后,未使用的 Subscription Anlas 会按要求清零,请在续订前合理安排生成量。
- 旧模型与旧端点会下线:官方曾公告在指定日期后把部分模型(如 Kayra)从主 API 下线、仅在专用生成端点提供,接口迁移需及时跟进官方文档。
- 优先看官方文档而非教程:api.novelai.net/docs 与两个生成端点的 Swagger 文档是一手来源,第三方教程里的端点与参数可能存在过期或改写。
NovelAI API 常见问题(FAQ)
Q:NovelAI 官方 API 地址是什么?
A:官方基址是 https://api.novelai.net,官方 API 文档在 https://api.novelai.net/docs/;图像与文本生成另有专用端点。
Q:NovelAI 有几个官方 API?
A:三个——主 API(api.novelai.net)、图像生成 API(image.novelai.net)、文本生成 API(text.novelai.net)。
Q:怎么获得 API Key?
A:NovelAI 不发放平台级 Key,需要使用用户自己的 Persistent API Token,可通过主 API 的 /user/create-persistent-token 创建。
Q:API 需要付费吗?
A:需要。API 调用依赖有效订阅,最低档 Tablet 为 $10/月,另有 Scroll $15、Opus $25 两档。
Q:网上卖的 NovelAI API 中转能用吗?
A:那些是第三方服务,不是官方端点。使用它们通常意味着要把你的凭据交给第三方,而官方明确不建议明文保存凭据,风险需自行评估。
Q:调用 API 会消耗什么?
A:订阅期内文本与语音不限量;图像生成消耗 Anlas,Anlas 分订阅额度与付费额度两类。
Q:Anlas 会过期吗?
A:会。订阅额度按已消耗量在续订时补足,而订阅结束或取消后,未使用的订阅额度将按要求清零。
Q:可以直接用 /user/ 下的接口吗?
A:不建议。官方明确要求第三方不要触碰主 API 中 /ai/ 以外的路由,账号与订阅类接口仅供其自身前端使用。
Q:第三方开发的应用该怎么接?
A:官方要求向用户索取其 Persistent API Token 放入 Authorization 头使用,并遵守 NovelAI 服务条款。
以上内容仅供参考,NovelAI 的 API 端点、订阅价格与计费规则可能随官方更新而变动,请以 api.novelai.net/docs/ 与 docs.novelai.net 官方文档最新公布为准。