AIをつなぐ

YukkuriGen で動画を作るのは、あなたが普段使っている AI です。 サイトの編集画面を開く必要はありません。ここでは、AI をつなぐところまでを説明します。

1. APIキーを発行する

APIキー設定ページを開き、 キーの名前（例: my-agent）を入れて「発行」を押します。

キーは発行直後の1回しか表示されません。 その場でコピーして保管してください。 無くしたときは、古いキーを失効させて新しく発行し直します。

無料プランでもキーは発行できます。できることの範囲は 料金プランを参照してください。

2-A. MCP でつなぐ（Claude Code / Cursor）

MCP に対応した AI なら、1行登録するだけです。

claude mcp add --transport http yukkurigen https://app.yukkurigen.com/api/mcp \
  --header "Authorization: Bearer <YOUR_KEY>"

登録できたら、AI に話しかけるだけで使えます。

節約術のゆっくり解説を作って。オチのところでカメラを寄せて。

2-B. REST でつなぐ（どの AI でも）

MCP が無い環境では、REST を直接叩きます。仕様は skill.md と openapi.json に置いてあるので、 この2つのURLを AI に読ませるのが早いです。

curl -X POST https://app.yukkurigen.com/api/v1/agent/generate \
  -H "Authorization: Bearer $YUKKURIGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "output": "ymmp",
    "title": "身近な熱力学のはなし",
    "script": [
      { "speaker": "reimu",  "text": "今日は熱力学第二法則を解説するわ" },
      { "speaker": "marisa", "text": "エントロピーってやつだな" },
      { "speaker": "reimu",  "text": "散らかった部屋が勝手に片付かないのと同じ理屈よ", "cameraMode": "dynamic" }
    ]
  }'

downloadUrl（24時間有効）が返ってきます。

キーが持つ権限

発行したキーには、YouTube アップロード以外のすべての権限が付きます。

権限	何ができるか
projects:read / projects:write	台本を読む・直す
script:generate	AI に台本を書かせる
audio:generate	音声を作る
export:ymmp	.ymmp を書き出す
render:mp4	MP4 をレンダーする
credits:read	残高を見る

youtube:upload は既定では付きません。必要なときだけ、発行時に明示します。

つながらないとき

応答	意味	対処
401 unauthenticated	キーが違う・失効している	APIキーページで発行し直す
402 plan_required	無料プランで MP4 レンダーを呼んだ	.ymmp を使うか、プランを上げる
402 insufficient_credits	残高が足りない	翌月まで待つか、クレジットパックを購入する
403 insufficient_scope	キーにその権限が無い	権限を付けて発行し直す

次は「使い方」で、作る・直す・出すの流れを見てください。