文件
計費
使用預付錢包按量付費。每次呼叫都會精確計量至微美分，並記錄在不可變更的帳本中。沒有訂閱，也沒有使用承諾，餘額永不過期。
透過 Stripe 儲值 → 餘額存入錢包 → 每次 API 呼叫即時扣除費用。餘額歸零時，呼叫會回傳 402 insufficient_quota，直到再次儲值。
定價模式
每次呼叫時，Kunavo 都會將以下兩個數值中的較大者作為使用者的費用：
- 目錄成本 — 模型卡上顯示的價格（每 1M Token、每張圖片、每秒影片等）× 實際使用量。
- 上游成本 — 上游供應商針對該次呼叫向 Kunavo 收取的費用，以額度計價，其中 1 個額度 = $0.005。
- 加價係數 — 通常為
1.5（在上游成本上加價 50%）。部分中國供應商模型的上游批發價格較接近供應商的官方價格，因此係數會降至1.2，以確保我們的價格低於官方價格。
max() 可確保：(a) 你的費用不會低於公布的目錄價格；(b) 若上游成本意外飆升，我們也不會在該次呼叫中虧損。
各模態的計費單位
| 模態 | 單位 | 粒度 |
|---|---|---|
| 聊天 | 每 1M 輸入 Token + 每 1M 輸出 Token | 精確到 token；推理 token 按輸出費率計費。 |
| 圖片（t2i / 編輯） | 每張圖片 | 按每張生成的圖片計費；未完成的生成不收費。 |
| 影片 | 每部影片 | 依解析度級別計價的每段影片固定價格。 |
較長的提示會依供應商的長上下文級別計費。對於 GPT-5.5、GPT-5.6 Sol 和 Terra，以及 GPT-6 Astra，輸入 Token 超過 272K 的提示會將整個請求按 2× 的輸入費率計費 — 快取讀取和寫入也包含在內 — 輸出則按 1.5× 費率計費，這是 OpenAI 公布的級別。Claude 不收取長上下文附加費：其 1M 上下文按標準費率計費。
快取 Token
聊天模型會快取穩定的提示前綴。快取讀取的費用遠低於一般輸入費率 — 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_cents1 cent = 1,000,000 micro_cents- 可精確計量的最低費用：
0.0001 cent（$0.000001）。實際的聊天呼叫通常會按此下限計費。
小額數值在控制台中四捨五入至 6 位小數（USD），達到美分級距後則四捨五入至 2 位小數。內部帳務採用精確計算。
儲值
透過 Stripe Checkout 在 /app/billing 為錢包儲值：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；中國大陸支援支付寶與微信支付；韓國支援 KakaoPay、Naver Pay、PAYCO、Samsung Pay 和韓國國內卡片；印度支援 UPI；巴西支援 Pix；荷蘭支援 iDEAL、比利時支援 Bancontact、奧地利支援 EPS、葡萄牙支援 MB WAY、義大利支援 Satispay；波蘭支援 BLIK；英國支援 Bacs Direct Debit；英國、愛爾蘭和芬蘭的買家支援 Pay by Bank。
級距定價
| 儲值 | 你可享有 | 額外獎勵 |
|---|---|---|
| $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 中儲存一張卡片，並設定三個數值：餘額低於多少時觸發儲值、每次增加的金額，以及每月上限。設定完成後，錢包就會自動補足餘額 — 當結算導致餘額低於門檻時，會在幾秒內完成；若期間有請求因餘額不足遭拒，則會在回覆該請求前完成 — 避免無人值守的代理程式因 402 而停止。
| 設定 | 範圍 | 備註 |
|---|---|---|
| 低於此餘額時觸發 | $5 – $1,000 | 請將此數值設為高於你最大的單次請求金額。 |
| 每次儲值金額 | $10 – $1,000，整數美元 | $100 和 $1,000 享有與手動加值相同的獎勵；其他金額不享有獎勵。 |
| 每月上限 | 儲值金額 – $20,000 | 計入每個日曆月的實際收費，不包括贈送額度。 |
KUNAVO* AUTOTOPUP。儲值處理期間，遭拒的請求會收到 402 和 Retry-After: 3；其他遭拒情況都會說明下一步該怎麼做。你可以隨時在同一頁關閉此功能或變更數值。
Webhook 時間
完成 Stripe Checkout 後，餘額會透過 webhook 更新。付款確認後，webhook 通常會在 5–10 秒內觸發。卡片付款接近即時；僅能非同步確認的付款方式可能需要數天才能結算。這些訂單在款項入帳前會顯示為 processing；結算 webhook 屆時會為錢包加值 — 你不必再次付款，等待期間也不會有任何項目過期。未完成的訂單會顯示為 pending，我們的清理工作會在 24 小時後將其標記為 expired；這個標籤僅供顯示，不會取消任何項目。
額度帳本
每次餘額異動都會記錄在僅能附加資料的帳本中：
| 類型 | 方向 | 何時 |
|---|---|---|
| topup | 入帳 (+) | Stripe 付款已確認。 |
| consume | 扣款 (−) | API 呼叫完成時收取費用。 |
| refund | 入帳 (+) | Stripe 退款或管理員手動加值。 |
| manual_ | 入帳／扣款 (+/−) | 管理員更正（例如事件退款）。 |
每筆記錄都會標記 balance_after_micro_cents，提供各事件當下的餘額快照。請前往 /app/billing 查看完整紀錄。
使用紀錄
每次 API 呼叫都會在 usage_logs 中新增一筆紀錄：
- 模型、狀態（成功／錯誤）、HTTP 狀態碼
- 輸入／輸出 token、快取與快取寫入 token、圖片數量、秒數、字元數
upstream_cost_micro_cents— Kunavo 支付給上游的費用cost_micro_cents— 您支付的費用（加價後）- 延遲、請求 IP、使用者代理程式、API 金鑰前綴
可在 /app/usage 查看，並使用篩選器與各次呼叫的詳細頁面。
失敗的呼叫會收費嗎？
不會。 Kunavo 只會在 status = success 時收費。若上游回傳 4xx／5xx，或我們的任務逾時，系統會記錄這次呼叫，但費用為 $0。上游費用由我們自行吸收，不會轉嫁給您。
退款
退款會透過 support@kunavo.com 個案處理。以下是常見的退款情況：
- Kunavo 端發生服務中斷，導致您的預算損失。
- 定價錯誤，導致您支付的費用高於目錄所示價格。
- 透過 Stripe 意外重複儲值。
退款預設會以額度退回您的錢包；您也可以提出申請，透過 Stripe 退款至銀行帳戶。