課金と返金
対話・画像・動画の課金方法、確保額の精算、課金されないケース、利用額の確認、チャージと返金の方法。
クレジット
残高はクレジットで表示され、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 件ごとに $0.40 の手数料がかかります。特典クレジットは返金対象外です。USDT での支払いも返金できます。