ヘルプトップへ

使い方

AIとの会話で「作る → 直す → 出す」を回す流れ。

最終更新: 2026-10-24

つなぎ終わったら、あとは AI に話しかけるだけです。ここでは、その裏で何が 起きているかを説明します。AI に指示する言葉と、AI が実際に呼ぶ道具を 並べてあるので、うまく動かないときの切り分けに使えます。

作る

「節約術のゆっくり解説を作って。背景は教室で」

AIが呼ぶものREST
create_yukkuri_videoPOST /api/v1/agent/generate
get_jobGET /api/v1/jobs/{jobId}
get_renderGET /api/v1/projects/{id}/render/{renderId}/progress

話者(speaker)とセリフ(text)の配列を渡すと、プロジェクトと台本が作られ、 数秒で jobId と projectId が返ります。 音声の合成と MP4 のレンダー開始は、 そのあとサーバ側のジョブとして進みます。この時点ではまだ renderId はありません。

  1. get_job に jobId を渡し、status が succeeded になるまで待つ
  2. result.renderId と projectId を get_render に渡して完成を待つ (succeeded は「レンダーが始まった」という意味で、動画はまだ焼いている途中です)
  3. done: true かつ outputFile が入ったら完成

get_job の応答が、次に何を呼ぶかを AI に案内します。 サーバの設定によっては、ジョブにせず待ってから renderId を直接返すこともあります(そのときは 2 から)。 output: "draft"(プロジェクトと台本を作るところで止める・消費なし)は、これまでどおりその場で返ります。

背景(backgroundImageUrl)は必ず指定してもらってください。 省略すると無地になり、画面の大半が空いた動画になります。

キャラクターは一座を混ぜられません。

  • ゆっくり(東方): reimu / marisa
  • 東北勢: zundamon / metan / tsumugi / anko

混ぜると 400 cast_mismatch が返ります(課金はされません)。

クレジットが動くタイミング

クレジット(本番は動画1分につき1)は受け付けた時点で押さえます。 残高不足や 402 plan_required はその場で返り、そのときプロジェクトもジョブも作られません。 本番の MP4 は、受け付けた時点では動画の長さがまだ決まらないので、台本の長さから見積もった分を押さえ、 音声ができて実際の長さが決まったら精算します(押さえすぎた分は戻ります)。

ジョブが failed になったら error.code に理由が入り、押さえた分は返金されます (残高への反映まで少しかかることがあります)。例外は、レンダーを起動したあとで ジョブだけが失敗した場合(まれ)で、このときレンダーは課金されたまま動いていて返金されません。 get_job がその旨と、結果を確かめるための renderId を案内します。

create_yukkuri_video(ジョブで受け付ける形)から MP4 までは、2026年9月25日に本番で最後まで通しました (22行の台本2本)。何本かをまとめて作る create_yukkuri_videos_batch で MP4 まで出す形は、本番ではまだ確かめていません。 初めての形の台本は、短い台本(30秒ほどなら1クレジット)で試し、get_render が完成を返すことを確かめてから流してください。

表情とポーズを付ける

行ごとに emotion(表情16種)と pose(腕の形)を付けられます。

{ "speaker": "zundamon", "text": "えっ、そうなのだ!?", "emotion": "surprise", "pose": "mouth_cover" }

どちらも1行も書かなければ、セリフの手がかりから自動で付きます。 1行でも書けば、書いた行だけがその指定になります。ポーズは東北キャラだけに効き、 そのキャラが描けないポーズは無視されます。一覧は キャラクター選び を見てください。

カメラを置く

盛り上がり・感情のピーク・オチの行に cameraMode: "dynamic" を付けると、 背景ごとカメラがその話者に寄ります。 立ち絵を消したい行は "summary"。

2〜4回に留めてください。 全行に付けると寄りっぱなしになって、寄りが効かなくなります。 立ち絵が画面に出ている行にだけ効きます。

直す

「3行目をもっと短くして」

AIが呼ぶものREST
get_projectGET /api/v1/projects/{id}
update_linesPATCH /api/v1/projects/{id}/lines

get_project が行番号つきで台本を返し、update_lines が指定した行だけを 差し替えます。渡さなかった行は一切変わらないので、気に入っている部分が消えません。

台本の読み書きにクレジットはかかりません。 何度直しても無料です。

見た目(テンプレート)を直す

「字幕を黄色で大きめにして、話者名も出して」「素材の画像をもう少し下に」

見た目を変える画面はありません(テンプレートの編集画面は 2026-10-14 に廃止しました)。 字幕の色・大きさ・フチ・箱、話者名、キャラや字幕・素材の位置、BGM の音量、背景は、AI に頼むと AI が直します。 組み込みのテンプレートは AI が複製してから直すので、組み込みそのものは変わりません。

AIが呼ぶものREST
copy_templatePOST /api/v1/agent/templates/copy
update_template_layout(位置)PATCH /api/v1/agent/templates/{templateId}/layout
update_template_style(字幕の書式・BGM・背景など)PATCH /api/v1/agent/templates/{templateId}/style
set_project_template(作った動画に当てる)PUT /api/v1/projects/{id}/template

見た目を変えてもクレジットはかかりません。 共有リンクで確かめてから書き出してください。 今あるテンプレートは「デザイン」で見られます(見るだけ)。

直したら音声を作り直す

text / speaker / reading を変えた行は、その行の音声が無効化されます。 古い音声を残すと、新しい字幕と違うことを喋る動画になるためです。 応答の audioInvalidated に行番号が入るので、generate_audio (POST /api/v1/projects/{id}/audio/generate)で作り直します。

確かめる

「書き出す前に見せて」

AIが呼ぶものREST
create_preview_linkPOST /api/v1/projects/{id}/preview-link

共有リンクを発行すると、全編・音つきでブラウザ再生できるURLが返ります。 ログイン不要で開けて、動画ファイルは作らないので0クレジットです(透かし入り。期限は既定7日)。 本番レンダーは動画1分につき1クレジット(全編の長さぶん)なので、見た目と音はここで確かめてから出してください。

以前あった「指定した範囲だけを低解像度で焼く MP4 プレビュー(1クレジット)」は 2026年9月27日に廃止しました。 render_mp4 に preview を付けたり output: "preview" を指定したりすると、課金されずに断られます。

出す

「本番で出して」

AIが呼ぶものREST
render_mp4POST /api/v1/projects/{id}/render
get_renderGET /api/v1/projects/{id}/render/{renderId}/progress

render_mp4 は行に載っている音声を再生するだけで、音声を作りはしません。 音声が無い行があるまま呼ぶと、課金せずに 409 missing_audio を返して止まります (無音の動画にクレジットを払わせないため)。missingAudioLines に対象行が入ります。

出力URLは署名つきで返ります。期限が切れたら get_render か GET /api/v1/projects/renders で取り直してください。

サイト側でやること

制作以外はサイトに残っています。

  • APIキー — 鍵の発行・失効
  • ホーム — 動画の作り方の手順と、AI とつながっているかの知らせ。 残高は画面上部のヘッダー、書き出した動画はサイドバーの「動画」にあります
  • 自分のキャラ — 自分の立ち絵(PSD・画像)の取り込みと設定。 PSD の取り込みはこの画面だけです。 PNG・WebP の画像1枚なら、AI に頼んで作ることもできます(create_character。→「キャラクター選び」)
  • プラン・請求 — プラン変更、クレジットパック購入
  • チャンネル設定 — YouTube 連携(OAuth)

チャンネル詳細ページの「設定」タブ(YouTube 連携セクション)

YouTube 連携はチャンネル詳細ページの「設定」タブから行います(画像は以前の画面で、タブの名前と並びが今と一部違います)。

自分で編集したいとき

制作画面(台本の編集画面)は残してあります。サイドバーの「チャンネル」でチャンネルを開き (ホームの「AI を使わずに手で作る」の「チャンネルを開く」からも行けます)、「新規動画作成」で作った動画か、 AI が作った動画を一覧から押すと開きます。サイドバーの「動画」の各動画の「編集」からも開けます。 直すのは AI との会話のほうが速いことが多いですが、行ごとの演出(立ち位置・上半身・カメラの寄り・動作・場面転換・章)は 台本エディタの「演出」の欄でも設定・確認でき、その行の頭で止めた共有プレビューで構図も確かめられます。 API と同じ形の JSON の台本も「台本読込」から読み込めます(→「ブラウザーで演出を設定する」)。 テンプレートそのものの見た目は、上の「見た目(テンプレート)を直す」のとおり AI に頼みます。