メインコンテンツへスキップ
POST
cURL
このエンドポイントを使用すると、Runway の video-to-video ワークフローで既存のソースクリップを変換できます。最終出力をすぐに返すのではなく、非同期タスクを開始します。

呼び出す前に

  • プロバイダーの入力要件に一致するソース動画を準備します
  • 必要な X-Runway-Version ヘッダーを含めて、必要な機能セットを指定します
  • 完全な絵コンテではなく、変更内容を説明する短いプロンプト(Prompt)1つから始めます

出力比率

このエンドポイントは、コロン区切りの ratio 値を想定しています。1280x720 出力には 1280:720720x1280 には 720:1280 を使用してください。1280x720 はすべての Runway video-to-video ルートで受け入れられるわけではありません。

タスクフロー

1

ソースクリップとプロンプトを送信

このエンドポイントからタスクを開始し、返された task id を保存します。
2

タスク詳細をポーリング

タスクが終了状態に達するまで、Runway タスクを取得する を使用します。
3

変換結果を保存

通常のメディアパイプラインを通じて、完成したアセットをダウンロードまたは永続化します。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ヘッダー

X-Runway-Version
string
必須

Runway API version header, for example 2024-11-06.

ボディ

application/json
videoUri
string
デフォルト:https://your-video-host/source.mp4
必須

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
デフォルト:A cat yawning in slow motion.
必須

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
デフォルト:1
必須

Random seed for reproducible results. Range: 0–4294967295.

model
string
デフォルト:gen4_aleph
必須

Model variant to use.

references
object[]
必須

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
デフォルト:1280:720
必須

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
必須

レスポンス

200 - application/json

success

id
string
必須

The ID of the task that was created. Use this to retrieve the task later.