アカウントツール¶
画像生成 API を呼び出さずにアカウントの状態を読み取り、コストを見積もる 3 つの ツールです。Anlas を消費しないため、頻繁に呼び出しても安全です。
get_subscription¶
アカウントのサブスクリプション情報と Anlas 残高を返します。
パラメーター¶
なし。
戻り値¶
NovelAI の /user/subscription レスポンスを反映した dict です。以下のキーと型は
実アカウントで観測したものです:
キー |
型 |
備考 |
|---|---|---|
|
|
0 = free、1 = starter、2 = …、3 = Opus。 |
|
|
サブスクリプションが現在有効かどうか。 |
|
|
NovelAI が報告するアカウント種別。 |
|
|
サブスクリプションの有効期限 (API が返す値)。 |
|
|
サブスクリプションが猶予期間中かどうか。 |
|
|
初回契約のアカウントかどうか。 |
|
|
PayPal で支払っているアカウントかどうか。 |
|
|
決済プロセッサーの ID。 |
|
|
検証したアカウントでは |
|
|
ティアの機能フラグ。 |
|
|
ティアに含まれる最大優先度アクション数。 |
|
|
ティアが開始するキューの優先度。 |
|
|
コンテキストトークンの許容量。 |
|
|
最大優先度が無制限かどうか。 |
|
|
含まれるモジュール学習ステップ数。 |
|
|
残りの 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 クライアントのコスト計算式を反映しています。
パラメーター¶
名前 |
型 |
デフォルト |
備考 |
|---|---|---|---|
|
|
必須 |
画像の幅 (px)。 |
|
|
必須 |
画像の高さ (px)。 |
|
|
必須 |
サンプラーのステップ数。 |
|
|
|
画像の枚数。 |
|
|
|
対象モデル。 |
|
|
|
|
|
|
|
|
|
|
|
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}
コスト表 (目安)¶
参考値 — 1 サンプル、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 (inpaint) は 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 フィールドはありません。
関連項目¶
設定 — 生成デフォルトを設定してコストを制御する