クレジット消費

MCP接続そのものに追加料金はかかりません。生成処理は、CMO AI Proの画面から同じ処理を行う場合と 同額のクレジットを消費します。

消費するツール

読み上げは、新規生成する行の画面に表示されるセリフ字数を合計し、100字単位で一度だけ切り上げます。 読み指定・演技タグの追加文字と再利用行は字数に含めません。新規301字なら4単位 × 10cr = 40crです。 音声工程の応答 creditQuantity はこの課金単位数で、クレジット額そのものではありません。

記事分析・動画分析はTeam・Agency・Enterpriseで利用条件を満たす組織だけが開始できます。動画分析の通し処理は文字起こしと詳細分析を二重に消費しません。単価は動画の長さで決まり、120秒以内は100、121〜180秒は150クレジットです。尺は登録の確認で決まるため、MCP の応答の見込み額は120秒以内の単価です。画面から行う動画の詳細再解析も、同じ長さの帯で1回100または150クレジットです。

記事LP動画の作成・編集はMCPで開始できます。素材を動画化する前に利用者の確認を取り、完成動画の採用と記事LPへの配置は画面で行います。記事画像の取り込みで始まった動き解析は motionAnalysis.jobIds で追跡できます。

バナー生成の消費量は「指定したテンプレート数 × 1テンプレートあたりの生成数」で決まります。 たとえばテンプレート2件 × 3案なら6案となり、360クレジットを消費します。

上記の数値は現在の設定です。単価は変更される場合があり、実際の消費量はサービス側の設定が 優先されます。最新の残高は get_credit_balance、単価はCMO AI Proの画面で確認できます。

消費しないツール

次のツールはクレジットを消費しません。

• すべての読み取り系ツール（list_*・get_*・search_templates）
• save_strategy（戦略仮説の保存）
• append_research_document（リサーチ本文への追記）
• save_material（input_type: "text"。本文を直接保存する場合）
• prepare_banner_template_upload / confirm_banner_template_upload（画像の登録のみ。AI解析は別）
• prepare_reference_image_upload / register_reference_image（案件参考画像の登録のみ）
• prepare_manga_style_image_upload / duplicate_manga_style / update_manga_style_panel_text_instruction / create_manga_work / import_manga_panels / update_manga_panel_script / update_manga_panel_reference_images / update_manga_panel（登録・投入・保存のみ）
• preview_article_images / list_article_images / get_article_creative_results（読み取り）
• prepare_video_analysis_upload / list_reference_analyses / get_reference_analysis / find_reference_analyses / get_reference_analysis_pattern / check_writing_draft（分析の準備・読み取り・点検）
• list_manga_styles / get_manga_style_candidates / list_manga_works / get_manga_work（読み取り）
• create_manga_short_video / get_manga_short_video / update_manga_short_video_settings / list_voice_presets / preview_voice / prepare_manga_short_video_audio_upload（登録・設定・試聴）

save_material は入力の種類で扱いが変わります。テキスト本文をそのまま保存する場合は消費しません。 URLを指定した場合は文字起こし処理が動くため消費します。

残高を確認する

生成を始める前に get_credit_balance で確認できます。

{
  "ok": true,
  "data": {
    "billing": "enforce",
    "total": 12000,
    "monthlyBalance": 10000,
    "purchasedBalance": 2000,
    "trialCarryoverBalance": 0,
    "trialCarryoverExpiresAt": null,
    "status": "active"
  }
}

total は月次付与分・購入分と、トライアルの残り（trialCarryoverBalance）の合計です。無料トライアル中に月額プランを契約した場合、トライアルの残りはトライアルの終了日時（trialCarryoverExpiresAt）まで使えます。生成時はトライアルの残り、月次付与分、購入分の順に消費されます。

残高が足りないとき

payment_required が返り、必要量と残高が含まれます。ジョブは登録されず、クレジットも消費されません。

{
  "ok": false,
  "error": {
    "code": "payment_required",
    "message": "クレジットが不足しています(必要60 / 残高10)",
    "required": 60,
    "balance": 10,
    "retryable": false
  }
}

同じ payment_required は、APIキーの日次上限に達した場合にも返ります。区別はメッセージで 確認してください。無料トライアル中の組織では、payment_required の応答に月額プランを案内する planNotice が付きます（エラー参照）。日次上限については利用上限を参照してください。

失敗したときの返金

生成ジョブが失敗した場合、CMO AI Proの既存ルールに従って利用クレジットが返金されます。 入力不備などでクレジット確保前に拒否された処理は、そもそも消費しません。

漫画ショート動画の目・口の動き（表情差分）は、組み立て全体が成功しても、顔が見つからない等で動かせなかった顔の分を 完成時にその顔の数だけ返金します（get_manga_short_video の expressionFailedFaces）。1枚の作画に上下の段があり、 話す段が組み立て前に決まらないコマで予約したが使わなかった枠も、同じく完成時に返金します（expressionUnusedReservedFaces）。

漫画ショート動画の絵の動き（動きの段階3）は、生成できなかった区画の分を完成時に返金します（animationFailedCuts）。 組み立て全体が失敗した場合も、作れて保存した区画の分は消費し、残りを返金します。保存した区画の動画は次の組み立てで再利用します（課金した秒は recentBuilds[].billedAnimationSeconds）。

ただし、APIキーごとの日次上限カウントは返金されても当日中は戻りません。これは残高とは別の 安全カウントです。

二重消費の防止

変更系ツールには idempotency_key が必須です。通信断などで結果がわからないときに同じキーで 再試行すれば、生成が二重に起動することも、クレジットが二重に消費されることもありません。