AI動画生成API
プロンプトを送れば、完成した動画が返ってきます。Yohが脚本を書き、一貫したキャラクターを配役し、声・音楽・字幕を加えてMP4を書き出します。ストーリー、シリーズ、クリップ、キャラクター、タイムライン、書き出しと、各ステップを自分で操作することもできます。
3回の呼び出しで最初の動画
キーを作成
サインインして Settings → API keys を開き、stories:generate と stories:read を持つキーを作成します。キーは一度しか表示されないので、サーバー側のシークレットに保存してください。確認してみましょう:
curl https://www.yoh.app/api/v1/credits \ -H "Authorization: Bearer $YOH_API_KEY"生成
X-Max-Generation-Credits があなたの同意です。このリクエストで受け入れる最大クレジット数を指定します。価格がそれを超える場合は HTTP 409 と見積もりが返り、課金はされません。同じ Idempotency-Key を再利用すれば安全にリトライできます。
curl -X POST https://www.yoh.app/api/v1/stories/generate \ -H "Authorization: Bearer $YOH_API_KEY" \ -H "X-Max-Generation-Credits: 500" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: my-first-video-1" \ -d '{ "prompt": "A dragon teaches a young knight how to fly", "contentType": "cinematic_story", "aspectRatio": "16:9", "scope": "full", "renderVideo": true }'ジョブをポーリング
ステータスが completed になるまで20秒ごとにポーリングします。レスポンスには storyId と MP4 の videoUrl が含まれます。
curl https://www.yoh.app/api/v1/stories/jobs/JOB_ID \ -H "Authorization: Bearer $YOH_API_KEY"
使いやすい理由
必要なときは細かく制御
シリーズとキャストを一度作れば、その中でエピソードを作れます。クリップの編集、1つのクリップの画像や動画の再生成、アップロードした自分の動画からのスタート、選んだタイムラインの書き出しもできます。
予測できる支出
有料のリクエストには、クレジット上限か承認済みの見積もりが必要です。無料のプレビュー(estimate、quoteOnly、dryRun)で、何かが始まる前に価格がわかります。
リトライ前提の設計
生成には冪等キー、ポーリングとキャンセルができる永続ジョブ、そして明確な終了ステータスがあります。
エージェントを使いたい場合は
同じアカウントとスコープがMCP経由でも使えるので、ClaudeやCodexがあなたの代わりにYohを呼び出せます。
よくある質問
テキストからAI動画を生成するAPIはありますか?
あります。POST /api/v1/stories/generate はプロンプトを受け取ってジョブを返します。完了すると、脚本、キャラクター、声、音楽、字幕付きの書き出し済みMP4が得られます。
APIの料金体系は?
アプリと同じYohクレジットを使います。有料のリクエストごとに受け入れる最大クレジット数を指定し、無料の見積もりエンドポイントで正確な価格を先に確認できます。
複数の動画で同じキャラクターを使えますか?
はい。キャラクター付きのシリーズを一度作り、その中でエピソードを生成すれば、どのエピソードも同じキャストを使います。
詳しいリファレンスはどこにありますか?
ドキュメントに、すべてのエンドポイント、スコープ、エラーと、その場で試せるプレイグラウンドがあります。
詳しい説明: Yoh ドキュメント · 料金 · OpenAPI 3.1
ほかの接続方法
- ClaudeでAI動画を作るClaudeをYohアカウントにつなげば、頼むだけで動画ストーリーができます。Claudeが脚本を書き、キャラクターの見た目をそろえ、クリップを生成し、タイムラインを編集して完成動画を書き出します。クレジットを使う前には必ず確認します。
- CodexでAI動画を作るCodexをYohにつなげば、ターミナルやエディタから動画ストーリーを制作できます。脚本、キャスト、クリップ、声、字幕から最終的な書き出しまで。有料の操作はすべて、先に価格を見せて承認を得てから進みます。
- AI動画のためのYoh MCPサーバーリモートMCPエンドポイント1つで、どのエージェントもYohのスタジオ全体を使えます。ストーリーを書き、キャラクターを決めて描き、声と音楽付きのクリップ動画を生成し、タイムラインと字幕を編集して、書き出しと公開まで。どのツールもyoh.appのエディタと同じルールで動きます。
- AIエージェントのためのYohスキルMCPサーバーはエージェントに道具を渡し、スキルは使いこなし方を教えます。オープンな Agent Skills 形式のSKILL.mdが、Yohのストーリーをうまく作る方法と、間違えやすいルールをエージェントに伝えます。