# 課金と使用量
> クレジット、制作と理解の前払い、成功時の使用量精算、返金。

クレジットは Agent が Beatra skills を呼び出すときに消費する独立したクォータ・
課金単位です。クレジットと法定通貨の固定レートはありません。各市場のチャージ
オファーが支払額に対するクレジット数を定め、公開モデル価格が操作ごとの消費量を定めます。

## 課金の仕組み

制作、音声、ボイス、音楽、画像・動画理解の専用 API は前払いです。送信時に
受理済みタスク価格を差し引き、最終使用量が変動する制作タスクは成功時に実測
使用量で精算します。理解では受理画像数または切り上げた入力動画秒数が送信前に
確定するため、送信時の差し引きが正確な料金です。公開ソーシャルデータの読み取り（`beatra.social.execute`）も前払いで、価格は 6 / 12 / 30 / 60 クレジットのいずれかであり、タスク作成前に確定します。

## 同時にいくつまで

| プラン | 同時に |
| --- | ---: |
| プランなし | 2 |
| スターター | 4 |
| ビルダー | 6 |
| プロ | 8 |
| スタジオ | 8 |

進行中がこの数に達しているとき、新しいリクエストは開始されず、課金もありません。ひとつ終わるのを待って同じリクエストを再送するか、同時にもっと進められるプランを選んでください。REST の毎分上限はレート制限のページを参照してください。

## 理解タスクの前払い

- `POST /v1/images/responses` は受け付けた画像 1 枚あたり 5 クレジット、最大 8 枚です。
- `POST /v1/videos/responses` は受け付けた入力動画 1 秒あたり 0.4 クレジット。秒数は
  切り上げます。
- `detail` とプロバイダー token 使用量は料金に影響しません。
- 理解タスクが失敗、またはキャンセルが確定した場合、送信時に差し引いたクレジットは標準の
  前払い返金経路で自動返金されます。

## 成功した前払いタスクの精算

最終的な課金量が受理されたメディアやプロバイダー出力に依存する場合、
送信時の差し引きは見積額です。成功時には、送信時に固定した価格スナップ
ショットと確定した実測使用量で精算します：

- 実使用量が少ない場合、未使用の見積額を `refunded_credits` に返金します。
- 同じ場合、ウォレット調整はありません。
- 受理済みリクエスト契約の範囲内で実使用量が多い場合、差額の追加課金を
  `charged_credits` に加えます。

実測使用量と入出力内訳が一致しない場合、または受理済みリクエストや
モデルの時間上限を超える場合、その値を実使用量や追加課金には適用しません。
送信時の差し引きは変更せず、タスクはオペレーター確認用の精算待ち状態を維持します。

最終純課金は `billing.net_charged_credits` として直接返されます
（`billing.charged_credits - billing.refunded_credits` と同額です）。
成功した超過利用で残高が負になることがあります。成果物は有効ですが、
チャージするまで新しい有料タスクは拒否されます。

## 失敗時の自動返金

タスクが `failed`、または停止が確認されて `canceled` になった場合、事前に差し引かれたクレジットは**自動的に元へ返金**されます。申請は不要です。キャンセル競合はタスクがまだ実行中であることを示し、返金は行われません：

```json
"billing": {
  "charged_credits": 48.0,
  "refunded_credits": 48.0,
  "net_charged_credits": 0.0
}
```

## レスポンス内の課金フィールド

すべてのタスク / 対話レスポンスに含まれます：

| フィールド | 説明 |
| --- | --- |
| `usage.credits` | 成功したリクエストが最終的に消費した正味クレジット |
| `usage.image_count` | 画像理解の受理画像数、または画像生成の成功出力数 |
| `usage.video_seconds` | 精算後の確定**出力**課金秒数（`usage.output_video_seconds` と同値。課金対象の入力分は input 側で別途報告） |
| `usage.input_video_seconds` / `usage.output_video_seconds` | 提供された場合の確定入力/出力秒数。`null` は確定内訳なしを意味し、0 と推測しない |
| `billing.net_charged_credits` | 実使用量精算と返金後の最終ウォレット純課金 |
| `billing.charged_credits` / `billing.refunded_credits` | 累積課金 / 累積返金。差し引きが最終純課金 |

## 残高とチャージ

グローバルコンソールでのクレジット購入は一回払いです（カード、Apple Pay、Google Pay、Link）。残高の確認とチャージは
[console.beatra.ai/wallet?intent=buy](https://console.beatra.ai/wallet?intent=buy) で行います。

クレジットはチャージ時にログインしているアカウントに入り、Agent が使えるのは接続先アカウントのクレジットだけです。チャージ画面には「チャージ先：…」が表示されます。アカウントが 2 つある場合は[アカウントと統合](https://docs.beatra.ai/ja/docs/accounts)をご覧ください。