ドキュメント

料金

前払いウォレットから従量課金されます。すべての呼び出しをマイクロセント単位で計測し、変更不能な台帳に記録します。サブスクリプションや利用義務はなく、残高に有効期限はありません。

Stripeでチャージすると、残高がウォレットに反映されます。その後、API呼び出しごとに料金がリアルタイムで差し引かれます。残高がゼロになると、再度チャージするまで呼び出しに 402 insufficient_quota が返されます。

料金モデル

呼び出しごとに、Kunavoは次の2つの金額のうち、大きい方をユーザーの料金として算出します。

user_cost = max(catalog_cost, upstream_cost × markup_factor)

カタログ料金 — モデルカードに表示された価格（100万トークンあたり、画像1枚あたり、動画1秒あたりなど）に実際の利用量を掛けた金額です。
上流コスト — 特定の呼び出しについて、上流プロバイダーがKunavoに請求した金額です。クレジット建てで、1クレジット = $0.005 です。
上乗せ係数 — 通常は1.5（上流プロバイダーから請求される費用に50%を上乗せ）です。一部の中国プロバイダーのモデルでは、上流の卸売価格がプロバイダーの公式料金に近いため、公式料金を下回るように係数を1.2に引き下げています。

max() を使用することで、(a) 表示されたカタログ価格を下回る料金を請求せず、(b) 上流コストが予期せず急増した場合にも、呼び出しごとに損失が発生しないようにしています。

モダリティ別の課金単位

モダリティ	単位	粒度
チャット	入力トークン100万個あたり + 出力トークン100万個あたり	トークン単位で正確。推論トークンには出力料金が課金されます。
画像（t2i / 編集）	画像1枚あたり	生成画像1枚あたり。部分的な生成には課金されません。
動画	動画1本あたり	解像度の区分に基づく、クリップごとの定額料金です。

長いプロンプトには、ベンダーの長文コンテキスト料金が適用されます。GPT-5.5、GPT-5.6 Sol、Terra、GPT-6 Astraでは、入力トークン数が272Kを超えるプロンプトのリクエスト全体に、2×の入力料金（キャッシュの読み取りと書き込みを含む）と、OpenAIが公開している料金区分に基づく 1.5× の出力料金が適用されます。Claudeには長文コンテキストの追加料金はありません。1Mコンテキストも標準料金で課金されます。

キャッシュされたトークン

チャットモデルでは、安定したプロンプトのプレフィックスをキャッシュできます。キャッシュの読み取り料金は通常の入力料金より大幅に低く、ClaudeとOpenAIのどちらでも 0.10×、および 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5 です。キャッシュの書き込み料金は、すべてのClaudeモデルで入力料金の 1.25× です（1時間TTLの書き込みを含み、Anthropicの 2× を下回ります）。GPT-5.6 Sol、Terra、Luna、および GPT-6 Astra でも同じ料金が適用されます。それ以外のすべてのモデルでは、通常の入力料金が適用されます。各クラスにはモデル固有の割引が適用されるため、キャッシュ料金も入力料金と出力料金と同じ割合でベンダーの定価から割り引かれます。上記の max() 下限もキャッシュを考慮して計算されるため、カタログ価格によって割引が相殺されず、お客様にも反映されます。

料金表の全体、cache_controlを有効にする方法、Kunavoのアフィニティルーティングでキャッシュを維持する方法については、プロンプトキャッシュガイドを参照してください。

精度

Kunavoでは、すべての金額を micro_cents で保存します。

1 USD = 100,000,000 micro_cents
1 cent = 1,000,000 micro_cents
最小課金単位：0.0001 cent（$0.000001）。一般的なチャット呼び出しは、この下限額で課金されることがよくあります。

ダッシュボードでは、米ドル（USD）の少額の値は小数点以下6桁に、セント単位に達した値は小数点以下2桁に丸めて表示します。内部の会計処理は正確です。

チャージ

/app/billingからStripe Checkoutを通じてウォレットにチャージできます。Stripeが対応する地域ではカード（Visa、Mastercard、Amex、JCB、UnionPay）を利用でき、インドを除くすべての地域ではApple Pay、Google Pay、Linkを利用できます。購入者自身の市場に応じて、国別の決済方法が表示されます。米国ではCash App Pay、Klarna、Afterpay、ACH銀行口座引き落とし（3～5営業日で決済）、暗号資産（ステーブルコイン）、さらに$100以上のチャージではAffirm、$100から$1,500までのチャージではZipが利用できます。中国本土ではAlipayとWeChat Pay、韓国ではKakaoPay、Naver Pay、PAYCO、Samsung Pay、韓国国内カード、インドではUPI、ブラジルではPix、オランダではiDEAL、ベルギーではBancontact、オーストリアではEPS、ポルトガルではMB WAY、イタリアではSatispay、ポーランドではBLIK、英国ではBacs Direct Debit、英国・アイルランド・フィンランドの購入者はPay by Bankを利用できます。

チャージはUSD建てで、Stripeが換算します。決済ページには利用者自身の通貨で金額が表示され、その通貨で決済されます。これが、ドル建ての料金に対してPixではレアル、BLIKではズウォティで請求される仕組みです。Stripeの為替レートには購入者が負担する2～4%の手数料が含まれます（StripeのAdaptive Pricingドキュメント、2026-10-03確認）。USDで支払えばこの手数料を避けられますが、現地の決済方法には現地通貨が必要です。SEPAダイレクトデビットは対象外です。当社アカウントで有効になっている決済方法に含まれていないため、表示されず、通貨設定を変更しても利用できません。SEPA諸国で発行されたカードは、SEPA口座から引き落とされるデビットカードを含め、通常どおり利用できます。

段階制料金

チャージ	利用できる内容	ボーナス
$10	$10.00	—
$100	$110.00	+$10 (10%)
$1,000	$1,200.00	+$200 (20%)
$5,000	$6,250.00	+$1,250 (25%)

残高に有効期限はありません。一度チャージすれば、数か月かけて使い切ることができます。また、/app/keysからAPIキーごとの月間利用額上限を設定すれば、個別のワークロードに上限を設けられます。キーの当月の利用額が設定した上限を超える場合、そのキーによる呼び出しは 402 insufficient_quota で拒否され、課金されません。他のキーは引き続き利用できます。同じ画面でキーごとに IP許可リストも設定できます。許可リスト以外からの呼び出しには 403 が返されます。

自動チャージ

任意の機能です。/app/billingでカードを一度保存し、3つの金額を設定します。チャージを開始する残高のしきい値、1回あたりのチャージ額、月間上限です。設定後はウォレットが自動で補充されます。確定処理によって残高がしきい値を下回ってから数秒以内にチャージされます。その間に残高不足でリクエストが拒否される場合は、応答前にチャージが行われます。そのため、無人エージェントも 402 によって停止しません。

設定	範囲	注記
チャージ開始残高	$5 – $1,000	最大の単一リクエスト額より高い金額に設定してください。
1回あたりのチャージ額	$10～$1,000、整数のドル単位	$100と$1,000には手動チャージと同じボーナスが付きます。それ以外の金額にはボーナスが付きません。
月間上限	チャージ額～$20,000	ボーナスを除く、各暦月の請求額が対象です。

カードまたはLink。Alipay、WeChat Pay、Pixなどの現地決済・銀行決済は自動課金できないため、通常これらを使って支払っている場合でも、自動チャージにはカード、またはカードを保有するLinkアカウントが必要です。1日の決済は最大5回です。3回連続で拒否されると自動チャージが一時停止し、メールで通知されます。カードの削除、異議申し立て、または不正利用ブロックが発生した場合は、直ちに停止します。すべての決済で領収書が送信され、明細にはKUNAVO* AUTOTOPUPと表示されます。

チャージ処理中にリクエストが拒否された場合は、Retry-After: 3 を含む 402 が返されます。それ以外の拒否では、次に取るべき対応が示されます。同じページから、いつでも自動チャージを無効にしたり、設定する数値を変更したりできます。

Webhookの処理タイミング

Stripe Checkoutの完了後、Webhookを通じて残高が更新されます。通常、決済の確認から5～10秒以内にWebhookが送信されます。カード決済の場合はほぼ即時に処理されます。非同期でのみ確認される決済方法では、決済確定まで数日かかることがあります。資金が着金するまでは注文が processing と表示され、決済確定後にWebhookがウォレットへ入金します。再度支払う必要はなく、待っている間に何かが失効することもありません。最後まで完了しなかった注文は pending と表示され、24時間後にクリーンアップ処理によって expired に変更されます。このラベルは表示上のもので、何かがキャンセルされるわけではありません。

クレジット台帳

残高のすべての変動は、追記専用の台帳に記録されます。

種類	方向	いつ
topup	クレジット（+）	Stripeの決済確認。
consume	デビット（−）	API呼び出しの完了時に料金を請求。
refund	クレジット（+）	Stripeによる返金または管理者による手動クレジット付与。
manual_adjust	クレジット（+/-）	運用担当者による訂正（インシデント時の返金など）。

各行に balance_after_micro_cents が記録され、イベントごとのスナップショットを確認できます。履歴全体は /app/billing から表示できます。

利用ログ

すべてのAPI呼び出しは usage_logs に1行ずつ記録されます。

モデル、ステータス（成功／エラー）、HTTPステータスコード
入力／出力トークン、キャッシュ済みトークン＋キャッシュ書き込みトークン、画像数、秒数、文字数
upstream_cost_micro_cents — Kunavoが上流プロバイダーに支払った金額
cost_micro_cents — お客様が支払った金額（マークアップ適用後）
レイテンシ、リクエスト元IP、ユーザーエージェント、APIキーのプレフィックス

フィルターとリクエストごとの詳細ページで、/app/usageから確認できます。

失敗した呼び出しに料金はかかりますか？

いいえ。 Kunavoが課金するのはstatus = successの場合のみです。上流プロバイダーが4xx／5xxを返した場合、または当社のタスクがタイムアウトした場合、呼び出しは記録されますが、費用は$0。上流の費用は当社が負担し、お客様には転嫁しません。

返金

返金はsupport@kunavo.com経由で個別に対応します。返金の対象となる一般的なケースは次のとおりです。

Kunavo側の障害により、お客様の予算が失われた場合。
価格設定の不具合により、表示されているカタログ価格より多く請求された場合。
Stripeで誤って二重にチャージした場合。

返金は原則としてウォレットへのクレジット付与で行います。ご希望の場合は、Stripe経由で銀行口座への返金も可能です。