課金と使用量
credits、制作と理解の前払い、成功時の使用量精算、返金。
Credits は Agent が Beatra skills を呼び出すときに消費する独立したクォータ・ 課金単位です。credits と法定通貨の固定レートはありません。各市場のチャージ オファーが支払額に対する credits 数を定め、公開モデル価格が操作ごとの消費量を定めます。
課金の仕組み
制作、音声、ボイス、音楽、画像・動画理解の専用 API は前払いです。送信時に
受理済みタスク価格を差し引き、最終使用量が変動する制作タスクは成功時に実測
使用量で精算します。理解では受理画像数または切り上げた入力動画秒数が送信前に
確定するため、送信時の差し引きが正確な料金です。Chat Completions は従来どおり
token 課金です。公開ソーシャルデータの読み取り（beatra.social.execute）も前払いで、価格は 6 / 12 / 30 / 60 credits のいずれかであり、タスク作成前に確定します。
同時にいくつまで
| プラン | 同時に |
|---|---|
| プランなし | 2 |
| スターター | 4 |
| ビルダー | 6 |
| プロ | 8 |
| スタジオ | 8 |
進行中がこの数に達しているとき、新しいリクエストは開始されず、課金もありません。ひとつ終わるのを待って同じリクエストを再送するか、同時にもっと進められるプランを選んでください。REST の毎分上限はレート制限のページを参照してください。
理解タスクの前払い
POST /v1/images/responsesは受理画像 1 枚あたり 5 credits、最大 8 枚です。POST /v1/videos/responsesは受理入力動画 1 秒あたり 0.4 credits。秒数は 切り上げます。detailとプロバイダー token 使用量は顧客料金に影響しません。- 理解タスクが失敗、またはキャンセル確定した場合、受理時の差し引きは標準の 前払い返金経路で自動返金されます。
成功した前払いタスクの精算
最終的な課金量が受理されたメディアやプロバイダー出力に依存する場合、 送信時の差し引きは見積額です。成功時には、送信時に固定した価格スナップ ショットと確定した実測使用量で精算します：
- 実使用量が少ない場合、未使用の見積額を
refunded_creditsに返金します。 - 同じ場合、ウォレット調整はありません。
- 受理済みリクエスト契約の範囲内で実使用量が多い場合、差額の追加課金を
charged_creditsに加えます。
実測使用量と入出力内訳が一致しない場合、または受理済みリクエストや モデルの時間上限を超える場合、その値を実使用量や追加課金には適用しません。 送信時の差し引きは変更せず、タスクはオペレーター確認用の精算待ち状態を維持します。
最終純課金は billing.net_charged_credits として直接返されます
（billing.charged_credits - billing.refunded_credits と同額です）。
成功した超過利用で残高が負になることがあります。成果物は有効ですが、
チャージするまで新しい有料タスクは拒否されます。
失敗時の自動返金
タスクが failed、または停止が確認されて canceled になった場合、事前に差し引かれた credits は自動的に元へ返金されます。申請は不要です。キャンセル競合はタスクがまだ実行中であることを示し、返金は行われません：
レスポンス内の課金フィールド
すべてのタスク / 対話レスポンスに含まれます：
| フィールド | 説明 |
|---|---|
usage.credits | 成功したリクエストが最終的に消費した正味 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 で行います。