課金と使用量

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

課金の仕組み

画像・動画・音声・音楽を問わず、課金対象の skill 実行はすべて前払いタスク です。送信時に見積額を差し引き、使用量が変動するタスクは成功時に実測使用量 で精算します。残高が見積額に満たない場合、API は 402 insufficient_balance を返し、タスクは作成されません。

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

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

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

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

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

失敗時の自動返金

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

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

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

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

残高とチャージ

コンソール console.beatra.ai → Billing で残高、履歴、チャージを確認できます。