runway-video の技術仕様
| 仕様 | 詳細 |
|---|---|
| モデル ID | runway-video |
| 提供元 | Runway |
| モデル種別 | AI 動画生成 |
| 主要モダリティ | 選択した基盤の Runway モデルに応じて、テキストから動画および画像から動画 |
| 入力 | テキストプロンプト、参照画像、場合によってはアップロードしたメディアアセット |
| 出力 | 生成されたビデオクリップ |
| API パターン | 非同期のタスクベース生成ワークフロー |
| 認証 | Bearer API キー認証 |
| 必須のバージョンヘッダー | X-Runway-Version: 2024-11-06 |
| ベース API ホスト | api.dev.runwayml.com |
| 公式 SDK | Node.js および Python SDK を利用可能 |
| ファイルハンドリング | 生成リクエスト向けに runwayUri 値を返す一時アップロードをサポート |
| 料金モデル | クレジットベースの課金。利用可能な Runway のビデオモデルは生成出力の秒数あたりで課金 |
| 例：基盤となるビデオモデル | gen4.5, gen4_turbo, gen4_aleph, veo3, veo3.1, veo3.1_fast, gen3a_turbo |
runway-video とは？
runway-video は、統一された API を通じて Runway の動画生成機能にアクセスするための CometAPI のプラットフォーム識別子です。Runway の公式 API ドキュメントに基づくと、Runway はテキストプロンプトや画像からクリップを生成する複数のビデオモデルを提供しており、生成開始と結果取得のためのタスクベースのエンドポイントを備えています。
実際には、runway-video は単一のスタンドアロンな基盤モデル名というよりも、Runway による動画作成ワークフローへのゲートウェイとして理解するのが適切です。Runway の現在の API カタログには、入力モードや価格帯が異なる複数のビデオモデルが含まれており、たとえばテキストまたは画像から動画を生成する gen4.5、画像から動画の gen4_turbo、さらに gen4_aleph、veo3、veo3.1、veo3.1_fast、gen3a_turbo といった選択肢があります。
これにより、runway-video は、クリエイティブなプロトタイピング、マーケティングコンテンツ生成、ソーシャルメディア向けクリップ制作、コンセプトの可視化、自動化された短尺動画合成を必要とする製品体験などの用途に適しています。Runway の API は非同期タスクを用いるため、統合では通常、まず生成リクエストを送信し、その後処理が完了するまでポーリングや結果取得を行います。
runway-video の主な機能
- テキストから動画の生成：対応モデル上で自然言語プロンプトから動画を作成でき、記述的なテキストから直接クリップを生成可能。
- 画像から動画のワークフロー：複数の Runway ビデオモデルが画像入力に対応しており、静止画のアニメーション化や参照ベースの動画生成パイプラインに有用。
- 複数の基盤モデルオプション：能力やコストが異なる複数のビデオモデルを公開しており、品質・速度・予算に合わせて最適化可能。
- 非同期タスク処理：生成リクエストはタスクを作成し、即時に最終メディアを返さないため、キューイング、再試行、ステータス確認が必要な本番環境に適合。
- 一時アセットのアップロード：アップロードエンドポイントが
runwayUriを返し、後続の生成リクエストに画像・動画・音声アセットを渡しやすくする。 - 公式 SDK のサポート：Node.js と Python の SDK により、認証、リクエスト作成、出力取得を簡素化。
- バージョン指定された API 連携：リクエストには明示的な
X-Runway-Versionヘッダーが必要で、既知の API 契約に基づく実装を支援。 - クレジットベースの料金：動画生成は生成秒数あたりのクレジットで課金され、選択した基盤モデルにより価格が異なる。
runway-video へのアクセスと統合方法
ステップ 1：API キーを取得
runway-video にアクセスするには、まずアカウントを作成し、CometAPI のダッシュボードから API キーを発行します。サインイン後、API キーをコピーし、本番環境では環境変数やシークレットマネージャーに安全に保管してください。
ステップ 2：runway-video API にリクエストを送信
API キーを使用して、runway-video 用の CometAPI エンドポイントに対するリクエストを認証します。リクエストボディにプロンプトおよびサポートされる入力パラメータを渡し、モデルとして runway-video を指定します。
curl -X POST "https://api.cometapi.com/v1/responses" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "runway-video",
"input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
}'
ステップ 3：結果を取得して検証する
送信後、runway-video に対して返される生成結果、タスク識別子、または結果ペイロードを API レスポンスで確認します。生成が非同期で実行される場合は、処理が完了するまで該当する CometAPI のエンドポイントをポーリングし、返却された動画の URL、メタデータ、コンテンツを検証したうえでアプリケーションで使用してください。