課金と使用量

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

課金の仕組み

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

残高が前払い額に足りない場合、API は 402 insufficient_balance を返し、タスクは作成されません。

AI ディレクター（beatra.speech.prepare_script、POST /v1/audio/speech/scripts）は後払いです。成功後、実際に使った入力・出力・推論トークン数で課金されます。開始するには、送信する文章の見積もり額を残高でまかなえる必要があります。見積もり額は、機能カタログにある 1,000 文字あたりの目安を文字数に応じて換算したもの（1,000 文字未満は 1,000 文字として数えます）で、同じアカウントで進行中の別の AI ディレクタータスクがあれば、その見積もり額も合わせて必要です。足りない場合、API は 402 insufficient_balance（details.reason は director_estimate）を返し、タスクは作成されません。課金額は実際の使用量に基づき、通常は見積もりを下回ります。その時点の残高を超える場合は、残高までの課金になります。

同時にいくつまで

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

ElevenLabs の音声合成には別の上限があります。プランに関係なく、1 アカウントあたり ElevenLabs の音声合成タスクは同時に 2 件までです。無料のクローン試聴も数に含まれ、MiniMax と Doubao のタスクは含まれません。3 件目のリクエストは 429 rate_limited（details.reason は speech_inflight_limit）を返し、課金されません。

AI ディレクターにも別の上限があります。プランに関係なく、1 アカウントあたり同時に進行できる AI ディレクタータスクは 2 件までで、プラットフォーム全体で同時に進行できる数にも上限があります。3 件目を送信すると 429 rate_limited（details.reason は director_inflight_limit）が返り（MCP 経由では上記のプランの上限が先に適用されることがあります）、AI ディレクターが混み合っているときは 429（details.reason は director_busy）が返ります。どちらの場合もタスクは開始されず、課金もありません。director_inflight_limit の場合は、このアカウントの AI ディレクタータスクが 1 件終わってから送信し直してください。director_busy の場合は、details.retry_after_seconds の秒数が経ってから再試行してください（REST では Retry-After ヘッダーに同じ秒数が入ります）。

理解タスクの前払い

• 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 になった場合、事前に差し引かれたクレジットは自動的に元へ返金されます。申請は不要です。キャンセル競合はタスクがまだ実行中であることを示し、返金は行われません：

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

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

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

残高とチャージ

クレジット購入は人民元建ての一回払いで、WeChat Pay でお支払いいただけます。残高の確認とチャージは console.beatra.cn/wallet?intent=buy で行います。

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