runway_video2video

runway-video2video の技術仕様

runway-video2video とは？

runway-video2video は、Runway の video-to-video 生成機能を指す CometAPI 上のモデル識別子で、既存の動画クリップを入力として受け取り、プロンプトに基づくガイダンスにより新たなビジュアルスタイルや動きの解釈へと再レンダリングするワークフローです。実際には、スタイライズ、シーン変換、ルック開発、実験的 VFX、そして生素材をよりシネマティックまたは創造的な出力へ変換する用途に用いられます。

Runway のヘルプドキュメントでは、Video to Video をテキストプロンプトや入力画像を最初のフレームとして用いて動画のスタイルを変更する方法として説明しています。より新しい製品ガイダンスでは、Gen-3 Alpha および Turbo がこのワークフローをサポートしていた一方で、最新の video-to-video ユースケースには Gen-4 Aleph などの新世代ツールを推奨しています。一方、CometAPI の統合観点では、runway-video2video はこの種の機能にアクセスするためのプラットフォームモデル ID です。

runway-video2video の主な機能

• 動画ガイド生成: 既存の動画入力を起点とし、一からモーションを生成するのではないため、ビジュアル結果を変えつつもショット構成、タイミング、コンポジションを維持できます。
• プロンプトベースの変換: 自然言語の指示によって、出力のスタイル、ムード、被写体の再解釈、あるいは視覚効果の方向性を制御します。
• スタイル転写とクリエイティブな再レンダリング: フレームごとの手動編集なしに、映像をアニメ調、シネマティック、シュルレアル、ブランド調のビジュアル表現へと変換するのに適しています。これは、Runway が説明する video-to-video スタイリングワークフローに基づく推測です。
• 参照対応ワークフロー: 関連する動画生成フローで、画像に基づくガイダンスのサポートが Runway のドキュメントに示されており、構図や美的整合性の誘導に役立ちます。
• 縦横出力オプション: 対応ワークフローには標準的な横向きと縦向きの出力形式が含まれ、ソーシャル、モバイル、マーケティング配信に有用です。
• 短尺制作の効率: 参照ワークフローは最長 20 秒の短いクリップをサポートし、広告クリエイティブ、コンセプトショット、ソーシャル投稿、迅速な反復パイプラインに適合します。
• API アクセス性: Runway は API ドキュメントとモデルへのアクセスパターンを提供しており、クリエイティブアプリ、社内ツール、自動化メディアパイプラインへのプログラムによる統合を可能にします。

runway-video2video のアクセスと統合方法

手順 1: API キーの取得（サインアップ）

まず、CometAPI にサインアップし、ダッシュボードから API キーを発行します。キーを取得したら安全に保管し、CometAPI エンドポイントへのリクエスト認証に使用します。

手順 2: runway-video2video API にリクエストを送信

CometAPI 経由で Runway の公式 API 形式を使用します。エンドポイントは POST /runwayml/v1/video_to_video です。X-Runway-Version ヘッダーを必ず含めてください。

curl https://api.cometapi.com/runwayml/v1/video_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "videoUri": "https://example.com/your-source-video.mp4",
    "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence with dramatic atmosphere and smooth motion.",
    "seed": 1,
    "ratio": "1280:720",
    "references": [],
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_to_video",
    headers={
        "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
        "Content-Type": "application/json",
        "X-Runway-Version": "2024-11-06",
    },
    json={
        "model": "gen4_aleph",
        "videoUri": "https://example.com/your-source-video.mp4",
        "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence.",
        "seed": 1,
        "ratio": "1280:720",
        "references": [],
        "contentModeration": {"publicFigureThreshold": "auto"},
    },
)
print(resp.json())

手順 3: 結果の取得と検証

API はタスクオブジェクトを返します。動画生成の完了を確認するためにタスクステータスのエンドポイントをポーリングし、完了後に出力動画の URL を取得します。本番環境では、リトライ、ステータスポーリング、ログ記録を追加し、runway-video2video との信頼性の高い統合を確保してください。