動画生成
エンドポイント
POST /v1/videos（非同期：作成 → ポーリング → ダウンロード）· トークングループmedia / media-gen
利用可能なモデル
| モデル名 | 説明 | 選択可能な長さ | 最初のフレーム参照画像 |
|---|---|---|---|
gemini-veo31 | Google Veo 3.1、高画質、1080p 対応 | 4s · 6s · 8s | ≤2 枚 |
runway-gen4-turbo | Runway Gen-4 Turbo（画像から動画専用） | 5s · 10s | 1 枚必須 |
grok-video | Grok Imagine（テキスト / 画像から動画） | 6s · 10s · 15s | ≤6 枚 |
firefly-ray | Adobe Firefly Ray | 5s · 10s | ≤2 枚 |
firefly-video | Adobe Firefly 動画、1080p 対応 | 5s | ≤2 枚 |
動画は秒単位で課金
価格 = 1 秒あたりの単価 × 長さ。タスク作成時に seconds パラメータで長さを指定します。タスクが失敗した場合は自動返金されます。各モデルのリアルタイム単価は 生成ワークベンチ をご覧ください。
いちばん簡単：生成ワークベンチを使う
- 生成ワークベンチ を開き、「🎬 動画生成」タブに切り替えます
- ご自身のトークン（
media / media-genグループ）を入力します - モデルを選択 → プロンプトを書く → 比率と長さを選択 → 「生成」をクリック
- 動画ができたら mp4 をダウンロードできます
動画は時間がかかる
動画生成は画像よりはるかに時間がかかり、数十秒から数分かかるのが普通です。ワークベンチには進捗のパーセンテージが表示されます。焦らず待ち、繰り返しクリックしないでください。
画像から動画（画像を最初のフレームにする）
画像を動画の最初のフレームとしてアップロードし、その画像を起点に動きのある動画をモデルに生成させます：
- ワークベンチ：「参照画像」をクリックしてアップロードします（
runway-gen4-turboは必須） - API：タスク作成時に multipart 形式を使い、画像を
input_referenceファイルフィールドに入れます。詳しくは API で呼び出す をご覧ください
対応している比率
よく使うのは 16:9 · 9:16 · 1:1；一部のモデルは 4:3、3:4、21:9、2:3、3:2 にも対応しています。生成ワークベンチ でそのモデルに表示される選択肢が正となります。API では size で表現します（例："1280x720" = 16:9；"1920x1080" = 1080p、一部モデルのみ対応）。
プロンプトの書き方
- 画面 + 動き + カメラワークを記述します。例：「岩に打ち寄せる波、スローモーション、映画のような質感」
- カメラワーク（ズームイン、回り込み、空撮…）が欲しい場合は、そのまま書き出してください
プログラムに組み込む
完全な API 形式とコードサンプルは API で呼び出す をご覧ください。問題が出たら よくあるエラー をご確認ください。