账户工具¶
三个读取账户状态、且不调用图像生成 API 就能估算成本的工具。它们可以放心 频繁调用 —— 不会消耗 Anlas。
get_subscription¶
返回账户的订阅详情与 Anlas 余额。
参数¶
无。
返回¶
dict,与 NovelAI /user/subscription 的响应一致。下表的键与类型均在真实
账户上观测得到:
键 |
类型 |
说明 |
|---|---|---|
|
|
0 = free,1 = starter,2 = …,3 = Opus。 |
|
|
订阅当前是否有效。 |
|
|
NovelAI 报告的账户类型。 |
|
|
订阅到期时间,按 API 返回的原样。 |
|
|
订阅是否处于宽限期。 |
|
|
账户是否为首次订阅者。 |
|
|
账户是否通过 PayPal 付款。 |
|
|
支付处理方 id。 |
|
|
在所探测的账户上为 |
|
|
档位功能标志。 |
|
|
该档位包含的最高优先级操作数。 |
|
|
该档位起始的队列优先级。 |
|
|
上下文 token 配额。 |
|
|
最高优先级是否不限量。 |
|
|
包含的模块训练步数。 |
|
|
剩余的 Anlas 等值步数。 |
|
|
剩余的固定(非购买)步数。 |
|
|
剩余的已购买步数。 |
示例¶
sub = await ctx.session.call_tool("get_subscription", {})
print(sub["tier"], sub["trainingStepsLeft"]["fixedTrainingStepsLeft"])
CLI¶
uv run python -m novelai_image_mcp info
get_user_data¶
返回已认证账户的用户数据。在下发生成命令之前,用它确认服务器当前认证的 是哪个账户。
参数¶
无。
返回¶
dict,包含:
键 |
类型 |
说明 |
|---|---|---|
|
|
账户注册邮箱。 |
|
|
注册来源(例如 |
|
|
内部 epoch。 |
示例¶
user = await ctx.session.call_tool("get_user_data", {})
print(f"Authenticated as: {user['email']}")
estimate_anlas_cost¶
不调用 API 就估算一次生成的 Anlas 消耗。与 NovelAI 公开 Web 客户端的 成本公式保持一致。
参数¶
名称 |
类型 |
默认值 |
说明 |
|---|---|---|---|
|
|
必填 |
图像宽度(像素)。 |
|
|
必填 |
图像高度(像素)。 |
|
|
必填 |
采样器步数。 |
|
|
|
图像数量。 |
|
|
|
目标模型。 |
|
|
|
|
|
|
|
|
|
|
|
是否启用 SMEA。 |
|
|
|
是否启用动态 SMEA。 |
|
|
|
自动 SMEA。 |
|
|
|
套用 Opus 档位的免费样本规则。 |
返回¶
dict,包含:
键 |
类型 |
说明 |
|---|---|---|
|
|
估算的 Anlas 消耗。 |
|
|
若适用 Opus 免费样本(不计 Anlas)则为 |
示例¶
cost = await ctx.session.call_tool("estimate_anlas_cost", {
"width": 832,
"height": 1216,
"steps": 28,
"n_samples": 4,
"model": "nai-diffusion-4-5-full",
})
# cost: {"anlas": 80, "opus_free_sample": False}
成本表(典型值)¶
供参考 —— 单张样本、nai-diffusion-4-5-full、28 步。使用本工具
实测。
txt2img(action="generate")
分辨率 |
|
|
|---|---|---|
512 × 768 |
8 |
0 |
832 × 1216 |
20 |
0 |
1024 × 1024 |
20 |
0 |
1536 × 1024 |
30 |
30 |
img2img(action="img2img"、strength=0.5)
分辨率 |
|
|
|---|---|---|
512 × 768 |
4 |
0 |
832 × 1216 |
10 |
0 |
1024 × 1024 |
10 |
0 |
1536 × 1024 |
15 |
15 |
备注
Opus 档订阅者对小型生成(≤1024²、≤28 步)享有免费样本:在该窗口内
opus=True 返回 anlas: 0 与 opus_free_sample: true。超出该窗口时,
opus 不改变估算结果。
infill(局部重绘)的计价与 generate 相同:832 × 1216、28 步、
strength=0.5 时为 20 Anlas。
成本随 n_samples 线性增长 —— 上面的示例(832 × 1216 的 4 张样本)为
4 × 20 = 80。
警告
在 V5 模型上,Opus 免费生成受 NovelAI 可补充的使用额度上限约束,额度用尽
后 API 会静默计费 Anlas。在昂贵的 V5 批量运行之前,先检查
get_subscription 的 trainingStepsLeft —— 订阅响应中没有单独的
usage 字段。
另请参见¶
配置 —— 设置生成默认值以控制成本