クレジット
API で Nodaro のクレジット残高と履歴を取得し、プランと価格を一覧にし、モデルや実行の料金を開始前に確認します。確保と返還の仕組みも説明します。
Nodaro Cloud で利用できます
クレジットは、Nodaro Cloud での支払いの単位です。API は、料金を常にクレジットで報告し、金額では報告しません。クレジットのエンドポイントは、残高とクレジットの履歴を返し、モデルや実行の料金を開始前に算出します。また、クライアントが通信しているデプロイメントが、そもそも使用量を計測しているかどうかも伝えます。
クレジットのエンドポイントは、Nodaro Cloud にだけあります。Community エディションと Business エディションにはクレジットの仕組みがないため、これらのルートは 404 を返します。例外は GET /v1/billing/surface で、すべてのエディションで応答します。
エンドポイント
| メソッド | パス | 説明 |
|---|---|---|
GET | /v1/credits/balance | 残高です。合計、サブスクリプション、チャージの各クレジットと、ティアを返します。 |
GET | /v1/user/credits | 1 日の使用量を含む、より詳しい残高のレコードです。 |
GET | /v1/credits/transactions | クレジットの履歴を、ページ単位で返します。 |
GET | /v1/credits/usage-summary | 期間内のクレジットの使用状況を、請求画面向けに集計して返します。 |
GET | /v1/credits/history | 残高のすべての動きを、ページ単位または CSV ファイルで返します。 |
POST | /v1/credits/model-costs | 公開。最大 50 個のモデル ID のクレジット料金です。 |
GET | /v1/credits/model-cost | 公開。1 つのモデル ID のクレジット料金です。ID は ?model= で送ります。 |
POST | /v1/credits/video-pro-estimate | 動画生成 Proの実行料金です。ジョブを参照してください。 |
POST | /v1/credits/seedance-ref-estimate | リファレンス動画を使う Seedance 2、Kling 4.0、Kling 4.0 Flash の実行料金です。Seedance のリファレンス動画の見積もりを参照してください。 |
GET | /v1/billing/plans | 公開。販売中のプランとクレジットパックを、価格とともに返します。 |
GET | /v1/billing/subscription | 自分のサブスクリプションと、アカウントが従うティアです。 |
GET | /v1/billing/surface | 公開。このデプロイメントが、使用量をどのように計測しているかを返します。 |
GET | /v1/billing/account | デプロイメントの請求システムから取得した、アカウントの概要です。 |
GET、POST、PUT | /v1/billing/… | 購入、請求書、カード、自動チャージ、決済です。ログイン済みのセッション専用です。購入と請求の管理を参照してください。 |
POST | /v1/jobs/cost-summary | 複数のジョブのクレジットを、まとめて返します。 |
公開ルートには、トークンは不要です。購入と請求の管理のための請求のルートは、ログイン済みのセッションにだけ応答します。それ以外のルートには、ほかのすべてのルートと同じトークンを使います。個人用 API トークン、OAuth トークン、セッションの JWT のいずれかです。
残高を読み取る
curl -s https://app.nodaro.ai/v1/credits/balance \
-H "Authorization: Bearer $NODARO_API_KEY"{ "total": 1250, "subscription": 1000, "topup": 250, "tier": "pro", "effectiveTier": "pro" }const balance = await client.credits.balance()
console.log(`${balance.total} credits (${balance.effectiveTier})`)total は、subscription と topup の合計です。tier は、保存されているサブスクリプションのティアで、free や pro などです。effectiveTier は、Nodaro が実際に適用するティアです。payg は、サブスクリプションはないもののクレジットを購入済みであることを示します。この場合、すべてのモデルが使え、ウォーターマークも 1 日の上限もありません。
SDK の client.credits.balance() が読み取る GET /v1/user/credits は、さらに多くの情報を返します。
| フィールド | 説明 |
|---|---|
total, subscription, topup | 上記と同じく、あなたのクレジットです。 |
dailySpent | 今日使ったクレジットです。 |
dailyLimit | 1 日の使用上限です。上限がない場合は null です。 |
monthlyAllocation | プランで、請求サイクルごとに付与されるクレジットです。 |
tier, effectiveTier | 保存されているティアと、適用されているティアです。 |
features | ティアで使える機能です。 |
periodEnd | 請求期間が終わる日時です。 |
appCreditsAllowance | アプリの利用で得たクレジットです。無料ティアの場合のみです。 |
使用時には、サブスクリプションのクレジットが先に使われます。サブスクリプションのクレジットは、年額プランでも毎月、プランの月間付与量にリセットされ、使わなかったサブスクリプションのクレジットは繰り越されません。チャージしたクレジットは購入から 12 か月間有効です。
更新の支払いに失敗すると、その期間に残っているサブスクリプションのクレジットは保留になります。更新の支払いが済むと、クレジットは戻ります。サブスクリプションが終わると、プランの残りのクレジットも一緒に終わります。アカウントは無料ティアに移り、サブスクリプションのクレジットは 0 になり、チャージしたクレジットは残ります。プランを終えても無料クレジットは追加されませんが、1 回限りの無料付与をまだ受け取っていないアカウントは、その後も受け取れます。アカウントがサブスクリプションを始めた時点で使っていない無料クレジットは、チャージしたクレジットに移り、ほかのチャージと同じく 12 か月間有効です。
デプロイメントは、クレジットの代わりに独自の単位を表示できます。その場合、GET /v1/user/credits には display も含まれます。これはサーバーが換算した同じ数値です。unit(単位のラベル)、decimals(数値の小数点以下の桁数)と、total、subscription、topup、dailySpent、dailyLimit、monthlyAllocation、appCreditsAllowance を持ちます。元のキーがあるときに限り、allowance: { granted, remaining }、externalWallet: { available }、welcomeOffer: { credits } も加わります。これらの数値はそのまま表示し、クレジットを自分で換算しないでください。null は取得できないことを表します。デプロイメントがインターフェースの言語ごとに単位の名前を決めている場合、display には unitLabels: { "<locale id>": "<word>" } も含まれます。インターフェースの言語のエントリを表示し、なければ unit を表示してください。単位が設定されていない場合と、請求アカウントが 1 つのデプロイメントで請求アカウント自身が読み取る場合(そのプールはクレジットのまま)は、display は含まれません。元のフィールドはどれも変わりません。
デプロイメントでウェルカムオファーを実施している間は、GET /v1/user/credits に welcomeOffer: { popupDue, popupSeen, consentPending, credits } も含まれます。credits は、受け取ると付与されるクレジットの数です。固定の数ではなく、この値を表示してください。consentPending: true の場合、credits はアカウントに付与された数です。以前のより大きな付与がそのまま残るため、現在受け取ると付与される数より多いことがあります。オファーを実施していない間は、このキーはありません。
popupDue は、ウェルカムポップアップを今自動で開くかどうかを示し、サーバーが判断します。ポップアップが自動で開く対象になるのは、付与が未受け取りで、後でが一度も選ばれておらず、ポップアップが自動で開いた回数が 3 回未満で、そのどれも直近 24 時間以内ではない間です。ポップアップへの回答になるのは後でだけです。回答せずに閉じた場合(×、Escape、外側のクリック)は、後日の訪問でまた自動で開けます。1 回の訪問で 2 回自動で開かないでください。回数はアカウントに記録されるため、すべてのアプリで共有されます。popupSeen は !popupDue で、popupDue より前に作られたアプリのために残されています。
POST /v1/credits/welcome-offer/seen は { event?: "shown" | "later" } を受け取ります。"shown" は、ポップアップが自動で開いたことを報告します。ポップアップが対象の間は表示を 1 回と数え、それ以外では何もしません。"later" は後でを報告し、ポップアップはそれ以降自動では開きません。ボディがない場合や、ほかの event の場合は "later" として扱われます。回答せずに閉じたことは、このルートを呼ばないことで報告してください。オファーは Nodaro の Web アプリで受け取ります。その 2 つのルート、POST /v1/credits/welcome-offer/claim と POST /v1/credits/welcome-offer/seen は、ログイン中のブラウザーセッションだけを受け付け、API トークンや OAuth アプリのトークンには 403 forbidden を返します。
クレジットの課金の流れ
- ジョブの開始時に確保されます。生成は、実行の前にその料金を確保します。残高が足りない場合、呼び出しは
402 insufficient_creditsを返し、requiredと、ほとんどのアカウントではbalanceも返します。ワークフローの実行では、各ノードが開始時にその料金を確保し、残高で料金を賄えないノードは失敗します。 - 結果を返したときに請求されます。確保された分が、そのまま請求になります。
- 結果を返さなければ返還されます。モデルのセーフティフィルターやデプロイメントのポリシーでブロックされた生成は、必ず返還されます。キャンセルされたジョブも同様です。例外は従量課金の LLM 呼び出しで、プロバイダーがすでに課金した使用分は請求されます。
- LLM の呼び出しは従量課金です。言語モデルの呼び出しは、まずクレジットを確保し、その後、使ったトークンに応じてモデルの単価で課金されます。LLM の呼び出しを参照してください。
- 実際に実行される内容で料金が決まります。選んだモデルに合わせてサーバーが設定を補正した場合、確保される額も補正後の値に従います。パラメーターの補正を参照してください。
ジョブの credit_status と取引の status は、同じ段階をたどります。まず reserved、次に committed か refunded です。そのため、クレジットが返還されたかどうかは、ジョブ自体から判断できます。ジョブのクレジットを参照してください。
取引履歴
GET /v1/credits/transactions は、クレジットの履歴を新しい順に返します。
| クエリ | 説明 |
|---|---|
limit | 1〜50 です。デフォルトは 20 です。 |
cursor | 前のページの nextCursor です。値は、最後の行の created_at の日時です。 |
curl -s "https://app.nodaro.ai/v1/credits/transactions?limit=2" \
-H "Authorization: Bearer $NODARO_API_KEY"{
"data": [
{
"id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e",
"created_at": "2026-09-26T14:03:11.284Z",
"credits_charged": 50,
"credits_reserved": 50,
"credits_used": 50,
"action": "generate-image",
"provider": "nano-banana-pro",
"status": "committed",
"metadata": { "model": "nano-banana-pro", "from_sub": 50, "from_topup": 0 },
"payer": "user",
"workspaceId": null
}
],
"nextCursor": "2026-09-26T14:03:11.284Z"
}| フィールド | 説明 |
|---|---|
credits_charged | 精算後に、その実行で実際にかかった料金です。確保した額より少ないことがあり、確保が返還された場合は 0、確保がまだ未精算のあいだ(status: "reserved")は null です。利用額を合計するには、このフィールドを足し合わせてください。 |
credits_reserved | 実行が受け付けられたときに確保した額です。この値は変わりません。 |
credits_used | credits_reserved と同じ確保額を、元の名前で返すものです。既存の連携のために残されています。一部だけ精算された場合も変わらないため、そうした実行では請求額より大きい値になります。credits_charged を使ってください。 |
action, provider | 何が、どのモデルで実行されたかです。 |
status | reserved、committed、refunded のいずれかです。 |
payer | 自分の残高から支払った場合は user、クラスやチームの予算から支払った場合は workspace です。 |
workspaceId | 支払ったワークスペース、または null です。 |
metadata | 実行がどのように課金されたかです。常にオブジェクトで、該当するものがない場合は {} です。 |
どの額を読むか。 実行は、まずクレジットを確保します。これが予約です。その後、実行は精算されます。確保した額の全部または一部が請求され、残りは残高に戻ります。実行によっては、確保した額より少なく精算されることがよくあります。たとえば、再レンダリングの可能性に備えた確保、実行後に測る長さ、従量で計測される実行です。そのため、確保した額は支払った額ではありません。たとえば、888 クレジットを確保して 444 クレジットが請求された実行は、credits_charged: 444、credits_reserved: 888、credits_used: 888、status: "committed" となります。残りの 444 クレジットは残高に戻っています。
status は予約のライフサイクルです。reserved(クレジットを確保済みで、まだ確定していない)、committed(実行が結果を返したため請求済み。請求額は credits_charged)、refunded(予約が解放された。たとえばセーフティブロックの後)のいずれかです。ジョブのペイロードでは、同じライフサイクルが credit_status として、精算された額が credits_charged として表示されます。そのため、ジョブの費用を知るのにトランザクションは必要ありません。ジョブのクレジットを参照してください。
metadata に入るのは、該当する場合の次のキーだけです。model、from_sub と from_topup(どちらの残高から支払ったか)、is_app_run、allowance_delta、web_free_mode、status、loop_trim_refunded、surround_refine_refunded です。
行がそれ以上ない場合、nextCursor は null です。
使用状況の集計
GET /v1/credits/usage-summary は、期間内のクレジットの使用状況を、請求画面の表示のように集計します。対象は個人のお金だけです。ワークスペースが支払った実行や、組織のクレジットは別のウォレットです。応答は { data: UsageSummary } です。
| クエリ | 意味 |
|---|---|
from、to | ISO のタイムスタンプ、または日付だけです。2026-10-01 は、その UTC の 1 日全体です。どちらも範囲に含まれます。デフォルトは、現在までの直近 30 日です。間隔は最大 1 年で、超えると 400 を返します。 |
bucket | 時系列の単位で、day、week、month のいずれかです。デフォルトは day です。 |
| フィールド | 意味 |
|---|---|
period | サーバーが受け取った { from, to, bucket } です。 |
totals | { used, purchased, granted, refunded, runs, avgPerRun } です。下記を参照してください。 |
mostUsed | byModel の最初の行です。実行がない場合は null です。 |
byModel | { model, provider, credits, runs, share } の行で、使用額の多い順です。share は used に占める割合で、0〜1 です。 |
byCategory | { category, credits, runs } の行です。category は image、video、audio、other のいずれかです。 |
overTime | 期間の単位ごとに 1 行で、空の単位も含めて古い順に並びます:{ bucket, used, purchased, runs }。bucket は UTC の日(2026-10-26)、週の月曜日、または月(2026-10)です。最初の単位は、週や月の途中からのことがあります。 |
bySession、byWorkflow | { id, name, tool, credits, runs, models, lastAt } の行で、使用額の多い順です。各セッションや各ワークフローにかかった額です。名前がない場合や削除された場合、name は null です。tool はセッションにだけあります。 |
truncated | 読み取りがサーバーの上限である 5,000 行に達し、数値が実際より少ない場合に true です。期間を短くしてください。 |
partial | 補助的な読み取りが失敗し、グループの一部が欠けているか名前がない場合に true です。合計は正しいままです。 |
totals の used は、各実行の課金額の合計です。実行中の実行は確保額で数え、返還された実行は数えません。purchased は、パック、チャージ、サブスクリプションの付与です。granted は無料のクレジットで、取り消された付与を差し引きます。refunded は、返還された実行や Stripe から戻った額です。実行が確保額より少なく精算されて戻った分は、返還ではありません。runs は、課金された実行と実行中の実行の数です。
SDK では client.credits.usageSummary()、CLI では nodaro billing summary です。
残高のすべての動き
GET /v1/credits/history は、残高のすべての動きを新しい順に { data: HistoryEntry[], nextCursor } として返します。実行、購入、付与、返還、調整、失効です。
| クエリ | 意味 |
|---|---|
limit | 1〜100 です。デフォルトは 50 です。 |
cursor | 前のページの nextCursor です。中身を解釈しない値で、ほかの文字列は 400 を返します。 |
kind | usage、purchase、grant、refund、app、adjustment、expiry のいずれかです。 |
model | モデルの識別子で、完全一致です。 |
from、to | ISO のタイムスタンプで、範囲に含まれます。 |
q | 説明に含まれる語です。 |
format | json、または絞り込んだ履歴全体をファイルにする csv です。CSV は最大 5,000 行で、ページ分けはありません。 |
| フィールド | 意味 |
|---|---|
id、at | 行と、その日時です。 |
kind、source | 何の動きかです。kind: "app" は、公開したアプリで得た、またはアプリに支払ったクレジットです。adjustment は管理者による修正とその他すべてです。source は記録自身の語で、usage、one_time_purchase、subscription_renewal、signup_grant、refund、app_earnings、expiry などです。 |
amount | 符号付きの動きです。実行の確保はマイナス、購入はプラスです。 |
balanceAfter | その直後の残高です。 |
pool | subscription、topup、mixed のいずれかです。 |
description | 記録のメモです。 |
model、provider | ジョブのある行で、実行されたモデルです。 |
charge、status | ジョブの確保の行、つまり実行が受け付けられたときの確保にだけあります。charge は、最終的に実行にかかった額です。精算された課金額、実行中は確保額、返還後は 0 です。status は reserved、committed、refunded のいずれかです。 |
job | ジョブのある行で、{ id, type, status, startedAt, completedAt, durationMs, workflowId, sessionId } です。ジョブが削除された場合、type などは null です。 |
receiptUrl | 領収書がある購入での、Stripe の領収書です。 |
同じジョブの返還の行や、従量課金の超過分の行では、charge: null です。そのため、一覧の charge を合計すると、各ジョブを 1 回だけ数えます。使用額には amount ではなく charge を読んでください。
CSV には同じフィールドが、動きごとに 1 行で入り、数値は数値のままです。最後の行は、5,000 行で切られたかどうかを示します。SDK では client.credits.history() と client.credits.exportHistory()、CLI ではファイル用の --csv を付けた nodaro billing history です。
1 つの請求アカウントがすべてのユーザーの分を支払うデプロイメントでは、使用状況の集計と履歴は、ほかの残高の読み取りと同じく、請求アカウント自身のセッションにだけ応答します。そのトークンには 403 payer_balance_jwt_only が返されます。
月次の明細メール
GET / PATCH /v1/user/settings で monthlyStatementEmail をオンにした人は、前月に支払いがあった場合に、毎月 1 日に短いメールを受け取ります。デフォルトはオフです。メールには、前月の支払いの書類が載ります。
- 支払った額。ドル建てで、返金を差し引いた額です。
- 請求書と領収書の件数。
- リンクのある書類のうち、最も新しいもののリンク。
GET /v1/billing/invoicesが一覧にする支払い済みの書類のうち、Stripe の請求書の PDF、または領収書のページです。 - 残高。
月は UTC の暦月です。支払いのない月には、何も送られません。
明細メールは Nodaro Cloud だけのもので、デプロイメントに明細メールが設定されている場合に限ります。設定のないデプロイメントは何も送りません。
ユーザー設定
GET /v1/user/settings は、サインインしている人自身の設定を返します:{ data: { tier, publicOutputs, promptTemplates, textTemplates, preferredLocale, mcpPreferences, showRecentNodes, showMostUsedNodes, variableDisplayMode, nodeDoubleClickAction, monthlyStatementEmail } }。
PATCH /v1/user/settings は、送ったフィールドを変更し、保存されたとおりに返します。送れるのは、tier を除く同じフィールドです。
promptTemplatesとtextTemplatesは、保存されている値を丸ごと置き換えます。mcpPreferencesは、image、video、audio、flowsの軸ごとにマージされます。省略したフィールドは保存済みの値を保ち、nullで送ったフィールドは消去されるため、MCP ツールはそのフィールドに独自のデフォルトを使います。たとえば{ "mcpPreferences": { "image": { "model": null } } }です。- Nodaro Cloud で
publicOutputs: falseにするには、Standard プラン以上が必要です。そうでない場合、応答は403です。 - 無効な値は
400 validation_errorで、変更するものがないパッチは400です。プロフィールがない場合は404です。
SDK では client.userSettings で、get() と update(patch) があります。
実行前に料金を確認する
| ルート | 料金を確認できるもの |
|---|---|
POST /v1/credits/model-costs | 最大 50 個のモデル ID の料金を、まとめて返します。 |
GET /v1/credits/model-cost | 1 つのモデル ID の料金です。 |
GET /v1/models | すべてのモデルの料金です。バリエーションごとに pricing のエントリーがあります。モデルを探すを参照してください。 |
GET /v1/nodes/:type | ノードの creditCost です。単一の料金か、料金の範囲です。 |
GET /v1/api/schema | ワークフロー全体の料金を、estimatedCredits として返します。ワークフローを参照してください。 |
POST /v1/credits/estimate-workflow | { nodes, edges? } として送るワークフローの料金です。{ data: { totalCredits, … } } を返します。 |
POST /v1/credits/video-pro-estimate | 動画生成 Pro の実行料金を、何も確保せずに返します。ジョブを参照してください。 |
POST /v1/credits/seedance-ref-estimate | リファレンス動画を使う Seedance 2、Kling 4.0、Kling 4.0 Flash の実行料金を、実行と同じ方法で測定して返します。下記を参照してください。 |
POST /v1/recast/estimate | Recast の実行料金です。Recast を参照してください。 |
POST /v1/pro-3d-render/quote | 3D レンダリング Proの実行料金です。3D シーンを参照してください。 |
モデルとノードの料金、そして estimatedCredits は、実行に請求される料金です。エディターの実行ボタンと同じ数値です。動画のトリミング、動画をループ、動画を結合では、ノードの creditCost は代わりに 5 秒の 1 段階分の料金で、実行の料金はこれに段階の数を掛けた額です。estimatedCredits では、動画の効果音ノードは 8 秒の料金で数えられます。クリップの長さは、実行の開始時に初めて測られるためです。実行時には、測った長さの料金が請求されます。
従量課金の LLM ノードを含む合計は、見積もりです。その場合、estimate-workflow は estimate: true を、GET /v1/api/schema は estimatedCreditsIsEstimate: true を加えます。そのような合計は ≈N と表示してください。これは、見積もりと固定料金の合計で、確保額ではありません。
クリップの長さで料金が決まるステップを正確に見積もるには、estimate-workflow のボディの upload-video ノードの data に、url と並べてクリップの duration(秒)と fps を含められます。その場合、動画マスクは、そのフレームレートでの長さで見積もられます。これは、実行の課金と同じルールです。動画のトリミングや動画をループの後、およびすべてのクリップが同じフレームレートを宣言している動画を結合の後でも使えます。
モデルの料金は設定によって変わることがあるため、バリエーションの ID には設定が含まれます。たとえば nano-banana-pro:4K や gpt-image-2:2K です。
curl -s -X POST https://app.nodaro.ai/v1/credits/model-costs \
-H "Authorization: Bearer $NODARO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"models": ["nano-banana-pro", "nano-banana-pro:4K", "gpt-image-2:2K"]}'{
"data": { "nano-banana-pro": 50, "nano-banana-pro:4K": 66, "gpt-image-2:2K": 42 },
"missing": [],
"errors": []
}const { data, missing } = await client.credits.modelCosts(['nano-banana-pro', 'nano-banana-pro:4K'])
console.log(data['nano-banana-pro:4K'])
if (missing.length) console.warn('No price for:', missing)単位あたりで料金が決まる実行の正確な料金
一部の実行は単位あたりで料金が決まり、実行は全体として料金が計算され、1 回だけ丸められます。そのため、単価に単位数を掛けた額は、実行の料金より大きくなることがあります。こうした実行の料金を確認するには、<row>:<N>u という ID を指定します。これは、その行の N 単位分の正確な料金です。POST /v1/credits/model-costs と GET /v1/credits/model-cost のどちらもこの ID に答えます。
| 実行 | 単位 | ID の例 |
|---|---|---|
| 音声のリクエスト | 開始した 100 文字ごと。8 から、モデルの 1 リクエストあたりの上限まで | elevenlabs-v4:per-100-chars:12u |
| EDL 適用または話者ビューのレンダリング | 1 分ごと | apply-edl:4u |
| 動画のトリミング、動画をループ、動画を結合、ナレーション付き動画を合成、マスク合成 | 5 秒ごと | trim-video:5u |
| LTX 2.3 Pro の延長またはリテイク | 1 秒ごと。N は小数でもかまいません | ltx-2.3-pro-retake:per-second:2.5u |
| 吹き替え | 開始した 1 分ごと。1〜30 | elevenlabs-dubbing:3u、ヘブライ語は elevenlabs-dubbing-v2:3u |
単位あたりで課金されない行や、その行のどの実行にもありえない単位数は、missing に入ります。音声を長さで課金しない環境では、<model>:per-100-chars:<N>u の ID もすべて missing に入ります。その場合は、モデルの定額の行で料金を確認してください。
ボイスチェンジャー Proの変換全体には、専用の ID があります。voice-changer-pro:<slot>,<slot>,… で、差し替えるボイスごとに 1 つのスロットを指定します。スロットは、声質変換のボイスなら sts-<seconds> で、そのステムの長さで指定します。再読み上げのボイスは、v3 なら respeak-<characters>、v4 なら respeak-v4-<characters>、v4 で翻訳を読み上げる場合は respeak-v4t-<characters> です。翻訳の場合は、文字起こしの文字数を送ります。セリフが再レンダリングされる分の上乗せは、サーバーが加えます。測る値がわからない場合は、種類だけを指定します。たとえば voice-changer-pro:sts-26.76,respeak-v4-1200,respeak-v4t-800 です。どちらのエンドポイントも、変換が確保するクレジットで答えます。変換には合計額を 1 回だけ丸めた額が請求されるため、ボイスごとの料金を足してもその数値にはなりません。スロットが 8 個を超える場合、1 時間より長いステム、不正な形式のスロットは missing に入ります。@nodaro/shared パッケージの voiceChangerProQuoteCreditId(slots) で、この ID を作れます。再読み上げのスロットには、省略可能な engine("v3" または "v4")と translated フラグを指定できます。
料金のない ID は missing に、料金の取得に失敗した ID は errors に入ります。そのため、1 つの不正な ID でリクエスト全体が失敗することはありません。これらの ID には、0 ではなくダッシュを表示してください。上の料金は例です。実際の値はレスポンスで確認するか、モデルで各モデルのページを参照してください。
CLI では、nodaro models cost <id…> で同じように ID の料金を調べられ、nodaro models list で各モデルのクレジットのティアを確認できます。
LLM の呼び出し
LLM の呼び出しには、固定の料金がありません。実際に使ったトークンに応じて、呼び出しを処理した経路でのモデルの単価で課金されます。LLM 呼び出しの課金のしくみを参照してください。
- 料金キーは
<feature>:<model>で、呼び出しがプロバイダー自身の API で実行される場合は:directが、料金が推論の強度で変わるモデルでは:effort-<level>が付きます。たとえばllm-chat:gemini-3.6-flashやdescribe-to-picker:claude-opus-5.5:directです。キーは、@nodaro/shared/llm-modelsのllmPriceKey(feature, model, reasoningEffort?, advancedMode?)で作れます。 - 答えは見積もりです。そのモデルでのその機能の一般的な呼び出しの料金です。
POST /v1/credits/model-costsはそのような ID をestimatesに一覧表示し、GET /v1/credits/model-costはdataにestimate: trueを加えます。見積もりは≈Nと表示してください。固定料金だけのバッチには、estimatesフィールドがありません。 - 単価のないモデルは、それが処理される経路に単価がない場合、実行できません。バッチは、そのキーを
errorsに一覧表示し、errorCodes: { "<key>": { code: "llm_model_unpriced", message } }を付けます。実行自体は、何かが確保される前に拒否されます。まだ料金のないモデルを参照してください。 missingにある従量課金のキーは、サーバーが LLM の呼び出しをモデルごとに料金設定していないことを意味します。料金は表示しないでください。- AI 分析付きの Meta 広告のスクレイピングは、固定のスクレイピング料金に、広告ごとの分析の呼び出し 1 回分を足した額を確保します。分析全体を 1 つの ID
<analysis key>:<items>uとして問い合わせてください。ID は@nodaro/shared/socialのscrapeAnalysisQuoteIdで作れます。答えは実行の数値を 1 回だけ切り上げたものなので、1 回の呼び出しの見積もりに項目数を掛けた額のほうが大きくなることがあります。
{
"data": { "llm-chat:gemini-3.6-flash": <credits>, "nano-banana-pro": <credits> },
"missing": [],
"errors": [],
"estimates": ["llm-chat:gemini-3.6-flash"]
}デプロイメント独自の単位での価格
クレジットの代わりに独自の単位を表示するデプロイメントでは、POST /v1/credits/model-costs が display: { unit, decimals, data } も返します。data は、同じ識別子を、サーバーが換算したその単位での価格に対応付けます。null は取得できないことを表します。GET /v1/credits/model-cost は、data に display: { unit, decimals, creditCost } を加えます。estimates にある識別子は、どちらでも見積もりです。
- これらの数値はそのまま表示してください。 クレジットを自分で換算しないでください。
unitLabels:デプロイメントがインターフェースの言語ごとに単位の名前を決めている場合、displayにはunitLabels: { "<locale id>": "<word>" }も含まれます。インターフェースの言語のエントリを表示し、なければunitを表示してください。サーバーはインターフェースの言語を知らないので、名前をすべて送り、選ぶのはクライアントです。- それ以外のデプロイメントでは
displayは含まれず、ほかのフィールドはどれも変わりません。
キャンセル:従量課金の LLM ジョブをキャンセルしても、確保額全体が請求されることはありません。呼び出しが始まったジョブには使った分が請求され、残りは返還されます。呼び出しが始まる前にキャンセルされたジョブは返還されます。ただし、同じジョブの以前の試行ですでに使った分は除きます。実行中のジョブに対する単独の POST /v1/jobs/:id/cancel は、inFlight: true を返し、ジョブを最後まで実行させます。ジョブのキャンセルと削除を参照してください。
Seedance のリファレンス動画の見積もり
リファレンス動画を使う Seedance 2 の実行は、リファレンスクリップの秒数と出力の秒数に対して課金されます。Kling 4.0(kling-4)または Kling 4.0 Flash(kling-4-flash)の実行は、出力の秒数に、出力とクリップのうち長いほうの秒数を足した分に対して課金されます。どちらの場合も、料金はクリップの実際の長さによって変わります。対象は、リファレンス動画を接続した動画生成と、動画から動画の Seedance 2.5 Edit の選択肢です。後者では、ソースクリップがリファレンス動画 1 になります。POST /v1/credits/seedance-ref-estimate は、クリップを測定し、実行の確保とまったく同じ方法で料金を計算します。ジョブは作成せず、何も確保しません。トークンが必要で、1 分あたり 60 リクエストまで送れます。
{ "provider": "seedance-2-5", "resolution": "720p", "duration": 8, "referenceVideoUrls": ["https://example.com/clip.mp4"] }| フィールド | 型 | 意味 |
|---|---|---|
provider | string | seedance-2、seedance-2-fast、seedance-2-mini、seedance-2-5、kling-4、kling-4-flash のいずれかです。ほかのモデルには 400 validation_error が返され、そのメッセージに対象となるモデルが示されます。 |
resolution | string、任意 | 実行が送る値と同じです。省くと、モデルのデフォルトになります。 |
duration | number、任意 | 出力の秒数です。-1 は自動を意味し、実行が確保するのと同じく計算されます。最長のクリップの長さを秒単位に切り上げて 1 秒を足した長さで、モデルの最長のクリップを超えることはありません。クリップが未測定または不明なあいだと、referenceTaskType が reference の場合は、モデルの最長のクリップで計算されます。省くと、モデルのデフォルトになります。 |
draft | boolean、任意 | Seedance 2.5 のドラフトで、480p で計算されます。 |
referenceTaskType | string、任意 | Seedance 2.5:実行が送るリファレンスのタスクタイプで、auto(デフォルト)、reference、edit、extend のいずれかです。実行と同じ方法で決まります。長さが自動の reference は、モデルの最長の出力で計算されます。edit と extend は、実行時の長さで計算されます。まだ作られていないクリップは、モデルの最長のクリップとして数えられます。ドラフトは、480p の同じリクエストとして見積もられます。ほかのモデルは無視し、不明な値も無視されます。 |
referenceVideoUrls | string[] | 実行が送るリファレンスクリップを、順番どおりに指定します。 |
unknownReferenceVideos | number、任意 | 上流のノードがまだ作っていないため、ファイルがまだ存在しない、接続済みのクリップの数です。 |
レスポンスは { "data": { "credits", "min", "exact" } } です。すべてのクリップを指定した場合、credits は実行が確保する値と完全に一致し、min も同じ値になります。測定できないクリップは、実行と同じく、モデルが受け付ける最長のクリップとして数えられます。unknownReferenceVideos がある場合、exact は false です。credits は不明なクリップをそれぞれモデルが受け付ける最長のクリップで計算します。min は、不明なクリップがどの長さになっても、実行が確保しうる最小の額です。referenceTaskType がある場合は、長いクリップのほうが安い実行になることがあり、min はそれも考慮します。どちらの数値も確保額です。長さをモデルが決める実行は、作った分で課金され、min を下回ることがあります。実行が拒否するクリップは、ここでも実行と同じ 400 video_too_long で拒否されます。エディターは、接続されたクリップがまだ作られていない間、ノード上に同じ範囲を表示します。
プランと価格
GET /v1/billing/plans は、販売中のプランとクレジットパックを、それぞれの価格とともに一覧にします。これは公開されたエンドポイントで、トークンは不要です。そのため、料金ページは誰かがログインする前にこれを呼び出せ、呼び出し元にかかわらず同じ内容が、Cache-Control: public, max-age=300 付きで返されます。応答する相手は、チェックアウトが通す相手と同じです。ユーザーに販売しないデプロイメントでは、ログインした請求アカウントだけが Cache-Control: private, max-age=300 付きで一覧を受け取り、それ以外には 403 self_serve_disabled が返されます。すべての応答に Vary: Authorization が付きます。応答するのは Nodaro Cloud だけです。SDK では client.billing.plans()、CLI では nodaro billing plans で、ログインは不要です。
{
"data": [
{ "id": "free", "name": "Free", "prices": null,
"signupCredits": <credits>, "parallelism": <n>, "storageBytes": <bytes> },
{ "id": "basic", "name": "Basic",
"prices": {
"monthly": { "priceId": "price_…", "amount": <amount>, "currency": "USD",
"credits": { "amount": <credits>, "per": "month" } },
"yearly": { "priceId": "price_…", "amount": <amount>, "currency": "USD", "perMonth": <amount>,
"credits": { "amount": <credits>, "per": "month" } }
},
"signupCredits": null, "parallelism": <n>, "storageBytes": <bytes> }
],
"topUps": [
{ "id": "topup-10", "credits": <credits>, "price": { "amount": <amount>, "currency": "USD" }, "priceId": "price_…" }
],
"topUpRange": { "min": <amount>, "max": <amount>, "currency": "USD" },
"stripePublishableKey": "<key>" | null
}| フィールド | 意味 |
|---|---|
data | プランです。無料プランが最初で、その後に有料プランが小さい順に続きます。id は変わりません。free、basic、standard、pro、business のいずれかです。 |
prices | 無料プランでは null です。それ以外では monthly と yearly です。priceId は、決済とプランの変更が受け取る Stripe の価格 ID、amount は通貨の主単位の金額、currency は ISO 4217 のコード、yearly.perMonth は年額を月数で割った金額です。現在販売できない価格は null です。無料ではなく、利用できないものとして表示してください。 |
prices.*.credits | その価格で付与されるもので、{ amount, per } です。per は "month" または "year" です。年額の価格でも、月額の価格と同じく、プランのクレジットが毎月付与されます。価格に記載がない場合は null です。 |
signupCredits | 無料プランで、登録時に 1 回だけ付与されるクレジットです。有料プランでは null で、クレジットは各価格に付きます。 |
parallelism | 1 つのワークフローで同時に実行されるノードの数です。 |
storageBytes | メディア用のストレージの容量(バイト)です。 |
topUps | クレジットパックで、{ id, credits, price, priceId } が小さい順に並びます。チャージしたクレジットは 12 か月間有効です。現在記載できない場合、price は null で、決済用の Stripe の価格 ID である priceId もあわせて null です。 |
topUpRange | { min, max, currency } です。この範囲の任意の整数の金額を、パックと同じレートで、アプリでクレジットとしてチャージできます。 |
stripePublishableKey | ページ内の支払いフォーム、つまり Stripe の埋め込み Checkout のための Stripe の公開可能キーです。デプロイメントにキーがない場合は null です。その場合は、Checkout のページに案内してください。自分のページの中で支払うを参照してください。 |
| ステータス | コード | 状況 |
|---|---|---|
403 | self_serve_disabled | デプロイメントがユーザーに販売しておらず、呼び出し元がその請求アカウントではありません。 |
503 | stripe_not_configured | デプロイメントがカード決済を受け付けていません。 |
503 | plan_prices_unavailable | 価格を読み取れませんでした。少し待ってから再試行してください。 |
プランを販売するには、ユーザーを Nodaro のアプリの料金ページに案内するか、ファーストパーティのアプリから決済を始めてください。購入と請求の管理を参照してください。
自分のプラン
GET /v1/billing/subscription は、ログイン中のセッション、ワークフローの制限がない個人用 API トークン、アプリの OAuth トークンに応答します。ワークフローが制限されたトークンには、403 forbidden が返されます。レスポンスは { data, effectiveTier } です。
dataは、アカウントの最新のサブスクリプションです。一度も契約していない場合はnullです。tier、status(active、trialing、past_due、unpaid(支払いの再試行が、支払いのないまま終わった状態)、paused、canceled、incomplete、incomplete_expired、expiredのいずれか)、current_period_start、current_period_end、cancel_at_period_end、cancel_at、canceled_atを持ちます。effectiveTierは、アカウントの機能が従うティアです。通常はGET /v1/billing/plansのプランのidです。サブスクリプションがなく、購入したクレジットを持つアカウントの"payg"や、"enterprise"のように販売されていないティアのこともあります。
現在のプランを示すには、effectiveTier をプランの一覧の data[].id と照合します。一致しない場合は、従量課金か、販売されていないティアです。SDK では client.billing.subscription()、CLI では nodaro billing subscription です。
購入と請求の管理
購入と請求の管理のためのルートは、ログイン済みのセッションにだけ応答します。これは、ファーストパーティの Web アプリが持つ Supabase の JWT です。API トークンと OAuth アプリのトークンは、403 forbidden で拒否されます。請求は app.nodaro.ai/billing で管理するか、SDK の client.billing からこれらのルートを呼ぶファーストパーティのアプリで管理します。
| メソッド | パス | 内容 |
|---|---|---|
POST | /v1/billing/create-checkout-session | プランやクレジットパックの Stripe Checkout を開きます:{ priceId, mode?, embedded?, returnPath?, uiMode?, replacesSessionId?, gaClientId?, gaSessionId? } で { data: { url } } を返します。プランの Checkout はプロモーションコードを受け付けますが、クレジットパックの Checkout は受け付けません。支払額 0 で確定したパックの購入では、クレジットは付与されません。アカウントにすでにサブスクリプション(有効または支払い遅延中)がある間、プランについては 409 を返します。そのプランは代わりに change-plan で変更してください。 |
POST | /v1/billing/create-load-session | 任意の金額を 1 ドル単位でクレジットとしてチャージする Stripe Checkout を開きます:{ amountUsd, embedded?, returnPath?, uiMode?, replacesSessionId?, gaClientId?, gaSessionId? } で { data: { url, credits } } を返します。 |
GET | /v1/billing/checkout-session/:sessionId | 自分の Checkout セッション 1 つの状態です。自分のページの中で支払うを参照してください。 |
POST | /v1/billing/change-plan | 有効なサブスクリプションを別のプランに移します:{ newPriceId } で { data: { subscriptionId, tier } } を返します。プランを変更するを参照してください。 |
POST | /v1/billing/manage-subscription | Stripe カスタマーポータルへのリンクです:{ returnPath? } で { data: { url } } を返します。最初の購入の前は 404 を返します。 |
GET | /v1/billing/auto-recharge | 自動チャージの設定です:{ data: { enabled, thresholdCredits, amountUsd, failureCount, lastAttemptAt, hasSavedCard } }。 |
PUT | /v1/billing/auto-recharge | 設定を変更します:{ enabled, thresholdCredits?, amountUsd? }。オンにするには、両方の数値が必要です。 |
GET | /v1/billing/transactions | 購入履歴で、新しい順に最新の 50 件です:{ data: [{ id, stripe_transaction_id, type, amount_usd, credits_granted, tier, created_at, receipt_url }] }。type は subscription、topup、refund のいずれかで、refund では credits_granted がマイナスです。 |
GET | /v1/billing/payment-method | Stripe に登録されている内容です:{ data: { card, billingDetails } }。card は { brand, last4, expMonth, expYear } または null、billingDetails は { name, email, country } または null です。まだ購入していないアカウントでは、エラーではなく、どちらも null です。 |
GET | /v1/billing/invoices | すべての支払いを書類として、新しい順に、各ソースの最新 100 件を返します。下記を参照してください。 |
GET /v1/billing/invoices の各書類は { id, kind, number, at, amount: { amount, currency }, credits, status, description, pdfUrl, url } です。
kind: "invoice"は、サブスクリプションの支払いです。number、pdfUrl、ホストされたurlは Stripe のものです。kind: "receipt"は、クレジットパックまたはチャージです。付与されたcreditsと、ホストされた領収書のurlがあり、PDF はありません。返金はstatus: "refunded"の領収書で、amountとcreditsはマイナスです。statusはpaid、open、void、uncollectible、refundedのいずれかです。- Stripe が作るすべての書類、つまり請求書の PDF、請求書のページ、領収書は、その人がどの言語で支払ったかにかかわらず英語です。
決済、チャージ、ポータルの returnPath は、Stripe がその人を戻す、呼び出し元のオリジン上のパスです。たとえば /billing や /settings/credits?tab=history です。そのため、独自のオリジンにあるファーストパーティのアプリは、自分の画面に戻れます。先頭に / が 1 つあり、クエリを含められ、ホスト、バックスラッシュ、# は含みません。それ以外は 400 を返します。決済とチャージは、クエリに checkout=success または checkout=cancelled を加えます。returnPath は embedded より優先されます。省くと、アプリ自身の /billing と /pricing のページが使われます。
決済とチャージの gaClientId と gaSessionId は任意です。訪問者の Google Analytics のクライアント ID とセッション ID で、_ga Cookie から読み取ります。これらは支払いに保存され、支払いが確定すると、その支払いを始めた訪問に結び付けてサイトのアナリティクスに報告されます。形式が正しくない値は無視され、拒否されることはありません。
自分のページの中で支払う
checkout と load の uiMode は、既定の "hosted"(Stripe の Checkout ページを開く)か、"embedded" です。"embedded" では、Stripe の Checkout フォームが自分のページの中に開き、応答は { data: { url: null, clientSecret, sessionId } } です。load では credits も加わります。フォームは、Stripe.js、clientSecret、GET /v1/billing/plans の stripePublishableKey を使って表示します。ほかの uiMode の値には 400 が返されます。
- フォームはリダイレクトしません。 リダイレクトが必要な支払い方法は表示されないため、
returnPathとembeddedは使われません。ただし、値は確認されるので、無効なreturnPathには引き続き400が返されます。 - このデプロイメントにフォームがない場合。 デプロイメントに公開可能キーがない場合、応答は
503 embedded_checkout_unavailableです。代わりに Checkout のページを使ってください。 - 購入は、いつもどおり付与されます。 Stripe が支払いの完了をプラットフォームに伝えたときです。いつ付与されたかは、セッションの状態を読んで確認します。
GET /v1/billing/checkout-session/:sessionId は、自分の Checkout セッション 1 つを読み取ります。応答は { data: { status, paymentStatus, mode, granted, paymentUnderWay } } です。
| フィールド | 意味 |
|---|---|
status | open、complete、expired のいずれかです。 |
paymentStatus | paid、unpaid、no_payment_required のいずれかです。 |
mode | payment または subscription です。 |
granted | 購入のクレジット、またはプランがアカウントに付与されると true になります。通常は支払いの数秒後で、後で確定する支払い方法ではもっと後になります。granted の後に、残高をもう一度読み取ってください。プランの granted は、そのクレジットより少し先に true になることがあるためです。 |
paymentUnderWay | セッションが開いていて、その支払いが送信済みのとき true です。このとき置き換えは 409 checkout_in_progress で拒否されます。送信済みの支払いが見当たらないときは false です。それでも、置き換えが拒否されることはあります。 |
自分のものではないセッション、または存在しないセッションには、404 checkout_session_not_found が返されます。1 分に 60 回を超える読み取りには 429 が返されます。
以前の Checkout セッションを置き換える
checkout と load の replacesSessionId は、このリクエストが置き換える、自分の Checkout セッションを指定します。たとえば、埋め込みフォームをやめて、Checkout のページを開く場合です。こうすると、2 つのセッションの両方が支払われることはありません。何かを作る前に、プラットフォームは以前のセッションを読み取ります。
| 以前のセッションの状態 | 応答 |
|---|---|
| 支払い済み、または後で確定する方法で支払い中 | 409 checkout_already_complete。もう一度リクエストしないでください。 |
| 支払い中:支払いが送信され、まだ確認中 | 409 checkout_in_progress。セッションの状態を読み取り、paymentUnderWay: false で open、または expired になってから、もう一度リクエストしてください。 |
| 開いていて、支払われていない | そのセッションを期限切れにしてから、新しいセッションを作ります。 |
| 期限切れ | 新しいセッションを作ります。 |
| 自分のものではない、見つからない、または同じ購入のものではない | 404 checkout_session_not_found。以前のセッションはそのまま残ります。 |
同じ購入とは、プランのリクエストならプランのセッション、パックならそのパックのセッション、load なら同じ金額の load のセッションです。状態を読み取った後でも、置き換えが拒否されることがあります。そのため、もう一度リクエストするのは、ユーザーが操作したときだけにするか、試す間隔を長くしてください。文字列ではない、空、または 255 文字より長い replacesSessionId には 400 が返されます。replacesSessionId がなければ、何も変わりません。
プランを変更する
POST /v1/billing/change-plan は、有効なサブスクリプションを別のプランに移します。何が起きるかは、変更の方向によって決まります。
- アップグレード。 請求期間の残りの価格差が、すぐに請求されます。新しいプランは、その支払いが成功したときにだけ適用されます。
- アップグレードのクレジット。 アカウントには、2 つのプランの月間クレジットの差が、請求期間ごとに 1 回だけ付与されます。同じ期間内にダウングレードしてからもう一度アップグレードしても、それ以上は付与されません。100% オフのクーポンや残高で賄われたなど、0 で確定したアップグレードの請求書では、クレジットは付与されません。
- アップグレードの支払いが通らない場合。 プランは変わらず、答えは
409で{ error: { code: "plan_change_payment_required", message, invoiceUrl } }です。invoiceUrlは、その請求書を支払うための Stripe のページです。請求書が期限切れになる前に支払われれば、変更が適用されます。前の変更がまだ支払いを待っている間も、同じ答えが返ります。 - ダウングレード。 未使用の期間は、次の請求書でクレジットされます。現在のクレジットは、期間が終わるまで残ります。
- 月払いから年払い、または年払いから月払い。 切り替えると請求期間が新しく始まりますが、クレジットは付与されません。次の月間クレジットは、切り替えの 1 か月後に付与されます。
そのほかの答えは次のとおりです。
- サブスクリプションが有効でない場合(たとえば更新の支払いに失敗したあと)は
409です。 - アカウントにサブスクリプションがない場合は
404です。 - 1 つのアカウントから 24 時間に 5 回プラン変更をリクエストしたあとは
429です。拒否されたリクエストも数えられます。
従量課金
API を使うのに、サブスクリプションは必要ありません。
- 購入すると有効になります。クレジットパックを購入するか、「請求」ページで 5〜1,000 ドルの範囲の任意の金額を 1 ドル単位でチャージすると、アカウントが従量課金に切り替わります。チャージ額が大きいほど、1 クレジットあたりの単価が安くなります。
- すべてが使えるようになります。
effectiveTierがpaygになり、すべてのモデルが使え、結果にウォーターマークが付かず、1 日の使用上限もなくなります。 - クレジットは購入から 12 か月間有効です。
- 開発者向けの経路で使えます。従量課金のクレジットは、API、SDK、CLI、MCP で使えます。Web エディターにはサブスクリプションが必要で、従量課金のアカウントがエディターからクレジットを使おうとすると、
403 subscription_requiredが返されます。トークンを使った呼び出しで、このエラーが返されることはありません。 - 一定の量を継続して使う場合は、サブスクリプションのほうが 1 クレジットあたりの単価が安くなります。
注意点が 2 つあります。
- 結果はデフォルトで公開されます。非公開の結果は Standard プラン以上のサブスクリプションの機能なので、従量課金での結果は公開ギャラリーに表示されます。MCP で作成したジョブは、常に非公開です。
- メディアは、アカウントが有効な間は保持されます。購入もクレジットの使用もない状態が約 3 か月続くと、60 日より古いファイルが削除されることがあります。再びクレジットを使うと、削除は止まります。削除されるのは、生成が自分の結果として保存したファイルだけです。結果が繰り返している入力や、ライブラリのアイテムがまだ保持しているファイルは削除されません。ファイルが削除されると、そのファイルを持つすべてのジョブの結果で、リンクが
nullになります。
購入には、その人自身のログイン済みセッションが必要です。決済、チャージ、プランの変更、自動チャージ、購入履歴、請求書、支払いポータルのための請求のルートは、API トークンと OAuth トークンを受け付けません。請求は app.nodaro.ai/billing で管理するか、購入と請求の管理を参照してください。
デプロイメントの使用量の計測方法を読み取る
次の 2 つのルートを使うと、クライアントは、デプロイメントの課金方法を前提にせずに、コストと使用量の表示を作れます。
GET /v1/billing/surface はトークンが不要で、誰にでも同じ内容を返します。
{
"data": {
"contract": 2,
"providerId": "…",
"displayUnit": "credits",
"canReport": true,
"canQuote": true,
"canAccount": true,
"mountCostTab": true,
"deploymentPayer": false
}
}displayUnitは、コストの表示でデフォルトで使う単位です。たとえばcreditsやusdです。- クレジットのない Community エディションの環境では、
providerIdはnone、mountCostTabはfalseになります。この場合、コストの表示は出さないでください。 - 1 つの請求アカウントがすべてのユーザーの分を支払う場合、
deploymentPayerはtrueです。それがどのアカウントかは、表示されません。
GET /v1/billing/account は、アカウントの概要を { "data": … } として返します。請求サービスが応答できない場合、data は null です。その場合は「利用できない」と表示し、残高 0 として表示しないでください。概要には、常に次のフィールドがあります。
| フィールド | 説明 |
|---|---|
plan | プランを表す文字列です。unknown も、有効な値です。 |
balance | 残高、または null です。 |
dailyAllowance | 1 日の利用枠、または null です。 |
unit | これらの数値の単位です。 |
デプロイメントによっては、任意のフィールドが追加されます。クライアントは、受け取ったフィールドだけを表示します。任意のフィールドは、periodStart、generations、spent、payg、daily、reserveValue、byCategory です。金額は、{ amount, currency } のオブジェクトです。daily の limit が 0 の場合は、無制限ではなく、ブロックされていることを意味します。daily と dailyAllowance の両方がある場合は、daily が優先されます。null はすべて「利用できない」を意味し、0 ではありません。ダッシュを表示してください。
POST /v1/jobs/cost-summary は、複数のジョブのクレジットを合計します。最上位と内訳の各行にある total_credits は、数値か null です。レスポンスには、単位を示す unit と、料金を算出できなかったジョブの数を示す unavailable が含まれます。合計が null の場合は、バッチ内のどのジョブにも既知の請求額がなかったことを意味します。0 という意味ではありません。
ワークスペースと共有の請求
- ワークスペースの予算:組織のワークスペース内での作業は、あなたの残高ではなく、ワークスペースの予算から支払われます。その取引には
payer: "workspace"が付きます。予算を超える実行では402 budget_exceededが、そのワークスペースでの自分の上限を超える実行では402 member_cap_exceededが返されます。ワークスペースと組織を参照してください。 - 1 つの請求アカウントで支払うデプロイメント:1 つの請求アカウントがすべてのユーザーの分を支払うデプロイメントでは、
GET /v1/user/creditsにallowance: { granted, remaining, enforced }が追加されます。これは、クレジット単位での自分の利用枠です。enforced: falseは、利用枠が表示されるだけで、実行は止められないことを意味します。請求アカウント自体の場合や、読み取れなかった場合、allowanceはnullになるので、nullを 0 と解釈しないでください。デプロイメントが利用枠を適用している場合、自分の利用枠を超える実行では402 user_allowance_exceededが返されます。請求アカウントは、プールされた残高を、自分のブラウザーセッションからだけ管理します。トークンでその残高を読み取ろうとすると、403 payer_balance_jwt_onlyが返されます。請求アカウントは、プリペイド残高の自動チャージをオンにしたり、読み取り専用の請求連携キーを作成したりすることもできます。請求アカウントのツールを参照してください。- そこでのプランはデプロイメントのプランです。 残高の読み取り、ユーザー設定、
GET /v1/billing/subscriptionでは、tierとeffectiveTierはデプロイメントのプラン、つまり請求アカウントのティアです。1 日の上限は適用されないので、dailyLimitはnullです。GET /v1/billing/subscriptionは、自分のサブスクリプションを引き続きdataとして返します。通常はnullです。 - そこでは無料の登録クレジットは適用されません。
POST /v1/credits/claim-signup-grantと 2 つのウェルカムオファーのルートは409 not_applicableを返し、同意も含めて何も記録しません。GET /v1/user/creditsにはwelcomeOfferが含まれません。
- そこでのプランはデプロイメントのプランです。 残高の読み取り、ユーザー設定、
- 外部ウォレット:独自のウォレットで支出を承認するデプロイメントについては、外部ウォレットを参照してください。
よくある質問
API でクレジット残高を確認するにはどうすればよいですか?
GET /v1/credits/balance を送信します。合計、サブスクリプション、チャージの各クレジットと、tier と effectiveTier が返されます。SDK の client.credits.balance() は、1 日の使用量も含む、より詳しいレコードを返します。
API での生成では、クレジットはいつ請求されますか?
クレジットは、ジョブの開始時に確保され、結果を返したときに請求されます。ジョブがセーフティフィルターやポリシーでブロックされた場合や、実行前にキャンセルされた場合は、確保されたクレジットが返還されます。どちらになったかは、ジョブの credit_status でわかります。
サブスクリプションなしで Nodaro API を使えますか?
はい。クレジットパックをどれか購入すると従量課金が有効になり、すべてのモデルが使えるようになります。ウォーターマークも 1 日の上限もありません。従量課金のクレジットは、API、SDK、CLI、MCP で使え、12 か月間有効です。
実行の料金を、開始する前に知るにはどうすればよいですか?
POST /v1/credits/model-costs は最大 50 個のモデル ID のクレジット料金を返し、GET /v1/models はすべてのモデルの料金ティアを一覧表示します。GET /v1/api/schema は、ワークフロー全体の料金を見積もります。動画生成 Proには、専用の見積もりルートがあります。
LLM の料金が ≈N と表示されるのはなぜですか?
LLM の呼び出しは、実際に使ったトークンに応じて、モデルの単価で課金されます。呼び出しの前に Nodaro が出せるのは、そのモデルでの一般的な呼び出しの見積もりだけです。POST /v1/credits/model-costs は、そのような ID を estimates に一覧表示するので、≈N と表示してください。
Nodaro のプランと価格を、自分の料金ページに表示できますか?
はい。GET /v1/billing/plans は公開されており、トークンは不要です。プラン、その月額と年額の価格、それぞれで付与されるクレジット、クレジットパックを一覧にします。購入には、その人自身のログイン済みセッションが必要です。
セルフホスティング環境で、クレジットのエンドポイントは使えますか?
いいえ。Community エディションと Business エディションにはクレジットの仕組みがないため、クレジットのルートは 404 を返し、ノードとモデルの記述子にもクレジット料金は含まれません。モデルのプロバイダーに直接支払います。
関連ページ
クレジット
ジョブ
エラー
ワークスペースと組織
Nodaro の AI モデル
最終更新