scenario-runway

Scenario Runway Video

概要

Scenario における Runway のモデル群は、用途によって分かれます。Gen4.5 はテキストまたは最初のフレーム画像から新しいクリップを生成し、Aleph 2 は既存の映像を書き換え、プロンプトで指定した対象を変更しながら、動き、音声、構成を維持します。両方を見つけるには search を使用し、仕様の確認には model_schema_get を使用します。

接続と基本的なワークフローについては scenario スキルを、モデルに依存しない動画作業については scenario-video スキルを参照してください。ここで名前が挙がっているスキルが利用可能なスキルに見つからない場合は、ユーザーにインストールを依頼してください（npx skills add scenario-labs/skills --skill <name>）。無人で処理を進める場合は、ツールのスキーマに従って作業し、不足しているスキルを明示してください。

クイックリファレンス

モードは入力によって決まります（名称と上限値はライブスキーマに基づきます）。

モード	入力	動作
テキスト（Gen4.5）	prompt	aspectRatio が適用されます。duration は 2～10 秒です
最初のフレーム（Gen4.5）	image + prompt	そのフレームから開始します。同じ duration が適用され、aspectRatio は無視されます
編集（Aleph 2）	video + prompt	映像を書き換えます。動き、音声、構成は維持されます

作成時点で Aleph のソース動画の上限は 30 秒かつ 16 MB で、それぞれ独立した制限でした。ビットレートの高いクリップは、先にサイズ上限に達します。コストの中央値は Gen4.5 の 6 倍近くで、ソース動画に応じて最大 15 倍の差がありました。まず正確なペイロードで dry_run を実行してください。レイテンシの中央値は 6 分近くに達するため、ジョブの途中で jobs_wait がタイムアウトします。その場合は pending_job_ids を指定して再度呼び出してください。

Gen4.5 のプロンプトはモードに合わせる

テキストモードでは、映像と動きの両方を説明する必要があります。最初のフレームで被写体、構図、カラーパレットが定まるため、プロンプトは動き、カメラ、雰囲気の説明に集中させてください。動作の順序を明示し（「ひざまずき、その後立ち上がる。カメラが上昇する」）、複数の動作を含むプロンプトには duration を 8～10 秒に設定してください。カメラの動き（固定カメラ、パン、ドリー、トラッキング、オービット、クレーン）は明確に指定し、1 つのクリップにつき 1～2 種類に絞って、現在形で記述してください。

aspectRatio にはピクセル比（"1280:720"、"960:960"）を指定します。作成時点でテキストモードに適用されたのは 16:9 と 9:16 の比率のみでした。それ以外の比率（1:1、4:3、3:4、21:9）にするには、その比率の画像を最初のフレームとして使用してください。

Aleph は指定した対象を変更する

Aleph のプロンプトでは、編集内容を明示します。削除、差し替え、スタイル変更、照明変更などを指定してください。指定していない要素は、動きや音声とともに維持されます。Aleph では動きを振り付け直したり、カメラワークを追加したりできません。動きを変更する必要がある場合は、Gen4.5 で生成してください。編集を調整するには、最大 5 枚の参照画像を指定します。keyframes では各画像（uri）を seconds または at（0～1 の小数）で配置し、promptImage では positionType と timestampSeconds または positionPercentage を指定します。これらの配列はどちらか一方を使用し、併用はできません。

実例：実写映像の商品を差し替える

1. target="models"、query="runway"、public=true を指定して search を実行します。たとえば、編集には model_runway-aleph-2、生成には model_runway-gen4-5 を使用します（作成時点のライブ検索結果です。セッションごとに再検索してください）。
2. 何よりも先に、Aleph の ID を指定して model_schema_get を実行します。
3. 上限を超えるソース動画はトリミングまたは圧縮します（scenario-video を参照）。クリップと商品画像を upload_asset でアップロードします（scenario スキルを参照）。
4. dry_run=true と、次の正確な parameters={"prompt": "Replace the soda can with the bottle from the reference image. Keep everything else unchanged.", "video": "asset_clip", "keyframes": [{"uri": "asset_bottle", "at": 0}]} を指定して model_run を実行します。トリミング後は再見積もりしてください。
5. 続けて wait=false で実行し、返されたジョブ ID を jobs_wait に渡します。必要に応じて pending_job_ids を指定して再度呼び出してください。タイムアウトは失敗ではなく、2 回目の model_run を実行する理由にはなりません。
6. 出力を asset_display で表示し、すべてのショットで差し替えが維持されていることを確認します。

よくある間違い

• keyframes と promptImage の両方を送ること：どちらか一方を選んでください。
• 画像モードのプロンプトで最初のフレームを言い換えること：代わりに、動きとカメラについて指定してください。
• aspectRatio に "16:9" を渡したり、image と併せて渡したりすること：ピクセルの組み合わせのみ指定でき、最初のフレームを指定するとそちらが優先されます。
• Aleph に新たな動きやカメラワークを求めること：ソースの動きは設計上、そのまま維持されます。