メインコンテンツへ移動

AI動画生成API

プロンプトを送れば、完成した動画が返ってきます。Yohが脚本を書き、一貫したキャラクターを配役し、声・音楽・字幕を加えてMP4を書き出します。ストーリー、シリーズ、クリップ、キャラクター、タイムライン、書き出しと、各ステップを自分で操作することもできます。

3回の呼び出しで最初の動画

  1. キーを作成

    サインインして Settings → API keys を開き、stories:generate と stories:read を持つキーを作成します。キーは一度しか表示されないので、サーバー側のシークレットに保存してください。確認してみましょう:

    curl https://www.yoh.app/api/v1/credits \
      -H "Authorization: Bearer $YOH_API_KEY"
  2. 生成

    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 }'
  3. ジョブをポーリング

    ステータスが 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

ほかの接続方法