クレジットの仕組みと賢い使い方
何にいくつクレジットを使うのか、いつ補充されるのか、足りなくなったときにパックとプランのどちらを選ぶか。
最終更新: 2026-10-20
YukkuriGen では、実費のかかる操作を「クレジット」で管理しています。 この記事では、何にいくつ使うのか、いつ補充されるのか、足りないときにどうするかを説明します。
何にいくつ使うか
| 操作 | 消費 |
|---|---|
| MP4 レンダー(本番・全編) | 動画1分につき1(端数は切り上げ) |
| BGM 生成(1曲・最長4分) | 2 |
| BGM の長尺づくり(4分ごとに1曲つなぐ) | 4分ごとに2(例: 1時間なら30) |
| 台本の読み書き・音声生成・共有リンク | 0 |
本番レンダーは動画の長さで決まります。30秒の動画なら1、2分10秒なら3、10分なら10です。
台本の読み書きは無料です。 台本を書くのはあなたがつないだ AI(ChatGPT・Claude)で、YukkuriGen 側で台本を生成することはありません。 get_project で読み返しても、update_lines で
行を差し替えても、クレジットは減りません。直すのはただで、
出すときだけ課金されるという設計です。
音声生成(VOICEVOX / AquesTalk)と、共有リンク(create_preview_link)での確認も無料です。
ただし音声生成には、クレジットとは別に月の文字数の上限があります(→下の「音声生成の月の文字数」)。
いつ減るか(台本から一気に作るとき)
AI に台本から MP4 を作らせると、YukkuriGen はまず注文を「ジョブ」として受け付け、
数秒で受付番号(jobId)を返します。クレジットはこの受け付けの時点で押さえます。
音声の合成とレンダーの開始は、そのあとサーバ側で進みます。
ジョブとして受け付けるのは、次のどちらかで頼んだときです。
- AI が MCP の
create_yukkuri_videoを使ったとき - REST の
POST /api/v1/agent/generateにPrefer: respond-asyncヘッダを付けたとき
ただし、サーバの設定によってはジョブにせず、音声の合成とレンダーの開始を待ってから結果を返すこともあります。
何本かをまとめて頼むとき(MCP の create_yukkuri_videos_batch、REST の
POST /api/v1/agent/generate/batch に Prefer: respond-async ヘッダを付けたとき)も、ジョブとして受け付けます。
ただしまとめて受け付けた時点ではクレジットを押さえません。 1本ずつ順に作り、その1本を作り始めるときに
その分を押さえます。押さえたあとの動きは、1本ずつの動画について下と同じです。
まとめたジョブ自体が failed になっても、それだけでは返金ではありません。作り始めた分は課金されたまま進み、動画も作られます。
ジョブとして受け付けたときのクレジットの動きは次のとおりです。
- 残高不足・プラン不足(
402)などはその場で返り、プロジェクトも作られず、残高も動きません - MP4 は、受け付けた時点ではまだ動画の長さが分からないので、台本の長さから見積もった分を押さえます。 音声ができて実際の長さが決まったら精算し、押さえすぎた分は戻します
- ジョブが
failedになったら、押さえた分は返金されます(残高への反映まで少しかかることがあります) - レンダーが始まったあとの失敗は、通常のレンダーと同じく、失敗が確定した時点で返金されます
- 例外は、レンダーを起動したあとでジョブだけが失敗した場合(まれ)で、レンダーは課金されたまま動いていて返金されません
output: "draft"(プロジェクトと台本を作るだけ)はクレジットを使いません。
焼く前に、共有リンクで確かめる(0クレジット)
MP4 を書き出す前の確認は共有リンクで行います。AI に create_preview_link
(REST は POST /api/v1/projects/{projectId}/preview-link)を呼ばせると、
全編・音つきで再生できるリンクが返ります。ログイン不要で開けて、動画ファイルは作らないので
クレジットは使いません(透かし入り。期限は既定7日)。
本番レンダーは動画1分につき1クレジット(10分の動画なら10)です。直すたびに焼き直して長さぶん取られると、 直すのが怖くなります。見た目と音は共有リンクで確かめ、納得してから1回だけ書き出してください。
以前あった「指定した範囲だけを低解像度で焼く MP4 プレビュー(1クレジット)」は
2026年9月27日に廃止しました。render_mp4 に preview を付けたり、output: "preview" を
指定したりすると、課金されずに断られます。
プランごとの付与量
| プラン | 月間クレジット | 目安 |
|---|---|---|
| フリー | 0 | 台本・音声・共有リンクは無料(MP4 はクレジットパックを買えば書き出せる) |
| スタンダード | 100 | MP4 100分ぶん(1分の動画なら100本) |
| プロ | 300 | MP4 300分ぶん(1分の動画なら300本) |
| エンタープライズ | 500万字(使いすぎを止めるための上限) | — |
無料プランは毎月の付与が0なので、MP4 の書き出しにはクレジットパックが要ります。
クレジットパック(買い切り)は無料プランのままでも買え、買ったクレジットが残っている間は MP4 を書き出せます(2026年10月5日から)。
クレジットパックもプラン(スタンダード以上)も API連携ライセンス(買い切り)も無い状態で頼むと 402 plan_required が返ります(課金はされません)。
台本づくり・音声生成・共有リンクでの確認は、無料プランでもクレジットを使わずにできます。
詳しくは「無料プランで MP4 を書き出すには」にまとめています。
残量とプランは、サイドバーの「残高」(プラン・課金管理の画面)の「今月の使用状況」で確認できます。
残高は画面上部のヘッダーにも出ています。AI からは get_credits(GET /api/v1/credits)でも取れます。
音声生成の月の文字数(クレジットとは別枠)
音声生成(VOICEVOX / AquesTalk)はクレジットを使いませんが、月に作れる文字数に上限があります。
数えるのは実際に読ませた文字数です(ルビや行全体の読みを書いた部分は、その読みの文字数)。
読みを確かめるだけの check_readings は数えません。
| 状態 | 月の文字数 |
|---|---|
| 無料プラン(購入なし) | 1万字 |
| 無料プランで、クレジットパックの残高がある・API連携ライセンスを持っている | 50万字(スタンダードと同じ) |
| スタンダード | 50万字 |
| プロ | 200万字 |
| エンタープライズ | 無制限 |
- クレジットパックで50万字になるのは、買ったクレジットが残っている間です。使い切ると、無料プランの1万字に戻ります
- 使った文字数が0に戻るのは、有料プラン(月額)を購読している人は次の請求日、それ以外(無料プラン・API連携ライセンス・パックだけの人)は日本時間の毎月1日です
- 上限に達すると、音声生成は
429 tts_quota_exceededで断られ、上限・使った文字数・戻る日時(resetAt)が返ります。 待っても戻る日までは作れません(すぐに投げ直しても通りません)。増やすには、クレジットパックを買うか、プランを上げます - 何行もまとめて作る途中で上限に達したら、作れる行だけ作り、越えた行は作りません(その行の結果に理由が入ります)。 作れなかった行は、クレジットも文字数も使いません
月次リセットと繰り越しのルール
- プラン付与分は毎月の請求サイクル開始日にリセットされ、翌月に繰り越されません
- 追加購入したクレジットパック分は別枠で、なくなるまで使えます(期限なし)
- 消費はプラン付与分から先に行われるため、購入分が先に減ることはありません
月末にプラン分が余っているなら、翌月に回そうとせず使い切るほうが合理的です。
使いすぎないためのコツ
- 確認は共有リンク(0)で、本番レンダー(1分につき1)は最後に1回。ここが一番効きます。
- 作り直さず、行だけ直す。
update_linesは無料です。create_yukkuri_videoを 呼び直すとレンダーにもう一度課金されるうえ、気に入っていた行まで変わります。 - 音声が無い行のままレンダーしない。
409 missing_audioで止まるので課金はされませんが、 往復が1回無駄になります。先にgenerate_audioを呼びます。 - カメラは2〜4回。全行
dynamicにしても消費は変わりませんが、出来上がりが悪くなります。
クレジットパックの買い足し
50 / 150 / 500 の3サイズをプラン・請求ページから 購入できます(画面の「クレジットパック」の「購入する」)。無料プランのままでも買えます。 購入分は月次リセットされず、期限もありません。
| パック | 価格 | 向いている場面 |
|---|---|---|
| 50 | ¥2,500 | 今月だけ数本多く作りたい・無料プランのまま試しに書き出したい |
| 150 | ¥6,500 | シリーズ物の一括制作、月をまたぐストック |
| 500 | ¥19,800 | 複数チャンネル運営、毎日投稿ペース |
不足が「今月だけ」ならパック、2〜3か月続くならプラン変更のほうが単価で有利になりやすいです。
プランを上げる判断基準
- 毎月、月の後半に必ずクレジットが尽きる
- 毎月クレジットパックを買い足している
- 無料プランのまま、毎月パックを買って MP4 を出している
- チャンネルを増やして並行運用を始めた
プラン変更はプラン・課金管理の画面の「プランを管理」から行えます。 アップグレードは即日新しいプランになり、差額は日割り計算で調整されます。ダウングレードは、現在の請求期間の終了時に切り替わります。 投稿ペースが安定していない段階では、まず小さいパックで様子を見て、 2か月連続で足りなくなった時点で上げる、という順番が失敗が少ないです。