KovAPIKovAPI

対話・画像・動画の課金方法、確保額の精算、課金されないケース、利用額の確認、チャージと返金の方法。

クレジット

残高はクレジットで表示され、1 米ドル = 200 クレジットです。料金ページとドキュメントの価格は米ドル建てで、課金時にこのレートでクレジットに換算します。/v1/usage は米ドルの残高とクレジットの両方を返します。

モデルの種類ごとの課金方法

種類課金単位補足
対話トークン単位:入力と出力で別々の料金(100 万トークンあたりの米ドル)キャッシュヒットはより安いキャッシュ読み取り料金、思考トークンは出力料金で課金します。
画像1 枚ごと、解像度のグレード(1K / 2K / 4K)ごとの料金実際に納品した枚数分だけ課金し、失敗した分は無料です。
動画ほとんどは秒単位(単価 × 長さ)、一部のモデルは 1 本ごと秒単位か 1 本ごとかは、料金ページと各モデルのドキュメントに記載しています。

各モデルの料金 →

対話の課金の詳細

  • usage.prompt_tokens が入力、usage.completion_tokens が出力です。キャッシュヒットした部分は、別途キャッシュ読み取り料金で課金します。
  • 推論モデルの思考トークンは出力に含まれ、思考の内容を読むかどうかに関係なく出力料金で課金します。ほとんどのモデルは、その数を usage.completion_tokens_details.reasoning_tokens で返します。
  • ストリーミングが途中で切れた場合は、切れるまでに生成された分だけを課金し、回答全体の料金はかかりません。
  • Claude のプロンプトキャッシュには「キャッシュ書き込み」の料金もあります。各モデルのキャッシュ読み取り・書き込みの料金は、そのモデルのドキュメントと料金ページに載っています。

確保と精算

  • リクエストを実行する前に、見積額を残高から確保します。残高が足りなければ 402 insufficient_quota が返り、モデルは呼び出されません。
  • 対話は実際の使用量で精算し、確保額の残りを返します。画像は納品した枚数で、動画は注文した長さまたは本数(確保額と同じ)で精算します。
  • 同時に実行するリクエストが多いほど、確保される額も増えます。残高に余裕がないと確保のために 402 が返ることがありますが、先のリクエストが精算されれば解消します。

失敗は課金されません

失敗したリクエストは一切課金されません。上流のエラー、タイムアウト、コンテンツ審査による拒否、ゲートウェイのエラーのいずれでも同じです。非同期タスクが失敗した場合は確保額が自動で全額戻り、理由はコールログに記録されます。

別のモデルが回答する場合

一部の対話モデルが一時的に使えないとき、リクエストが失敗しないよう、ゲートウェイが別のモデルに回答させることがあります。その場合は 2 つのモデルのうち安いほうの料金で課金し、どのモデルが回答し、どの料金を適用したかをコールログに記載します。

利用額の確認

  • コンソールの「コールログ」:直近 60 日間のすべての呼び出しについて、モデル、所要時間、使用量、課金額を表示します。失敗した呼び出しには理由も表示されます。
  • コンソールの「使用量」:日別・モデル別・キー別の集計を表示し、CSV にエクスポートできます。
  • プログラムから:GET /v1/usage が残高、累計と今日の利用額、モデル別の利用状況を返します。詳しくは API リファレンス をご覧ください。

チャージと返金

チャージはコンソールの「請求」ページで行います。WeChat Pay なら ¥10(260 クレジット)から、USDT やカードなら $5 からです。クレジットに有効期限はありません。登録時と初回チャージ時の特典は よくある質問 で説明しています。

チャージから 7 日以内であれば、未使用の購入クレジットはサポート経由で返金でき、返金 1 件ごとに手数料(2026 年 10 月 29 日以降のチャージは $1.40、それ以前は $0.40)がかかります。特典クレジットは返金対象外です。USDT での支払いも返金できます。

USDT でのチャージ

コンソールの「請求」ページで USDT、パッケージ、チェーンを選ぶと、ネットワーク・送金する正確な金額・受取アドレスが書かれた支払いページが表示されます。この 3 つのとおりに 1 回送金すると、オンチェーンで確認され次第クレジットが自動で反映されます(通常は数分)。

  • チェーンの選び方:既定は BEP20 で、取引所では BSC / BNB Smart Chain と表示され、出金手数料が最も安くなります(Binance の参考値で約 0.01 USDT)。スキャン後にこのネットワークを手動で選び、ETH や opBNB は選ばないでください。Solana は Binance や OKX でスキャンするとネットワークが自動で選ばれますが、出金手数料は高めです(Binance の参考値で約 0.3 USDT)。TRC20(取引所では TRX · Tron)は手数料が最も高くなります(Binance の参考値で約 1.5 USDT)。必ず支払いページに書かれたチェーンで送金してください。別のチェーンに送った資金は取り戻せません。
  • 金額はぴったりに:同じチェーンの注文は 1 つの受取アドレスを共有しており、システムは小数点以下まで一致する金額でどの注文かを判別します。着金額は支払いページの数字とちょうど同じである必要があり、多くても少なくても自動では反映されません。
  • 手数料は入力額から差し引かれます:取引所から出金するとき、出金手数料は入力した数量から差し引かれます。「受取数量 / Recipient receives」の欄を見て、支払いページの金額とちょうど同じになるようにしてください。Binance では受取数量の横の ⇆ をタップすると、受取額を直接入力できます。
  • 支払いページの有効期限は 60 分です:期限内に送金してください。期限切れ後の送金は自動では反映されないため、新しく注文し直してください。
  • 支払ったのに反映されない場合:二重に支払わないでください。注文番号(支払いページの下部)と取引ハッシュ(TxID)を添えてご連絡ください。確認のうえ手動で反映します。通常 1 時間以内に対応します。

お問い合わせ →