RunwayをAIアプリ・開発ツールとつなぐ手順（その2）：Runway API・公式SDK、DaVinci Resolve・Premiere Proのプラグイン、組み合わせの案

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。

公式ページは要約の形で取得しました。コードが崩れて読めたものは、「全文は公式ページで確認」と書き、写しとは呼びません。キーの実値は書かず、<YOUR_API_KEY> に置き換えて書きます。画面の表記は変わるので、手元の画面と照らして読んでください。MCPの手順は、その1（07）です。

先に結論

• プログラムから使うなら、APIとSDK。 開発者ポータルでプロジェクトをつくり、キーをつくり、クレジットを足し、環境変数に入れる、の順です。
• 編集ソフトの中で使うなら、プラグイン。 無料でダウンロードでき、生成にStandard以上のプランが要ります。
• キーは人ではなくプロジェクトのもの。 止めるには、キーそのものを無効にします。

前提：用語をそろえる

• APIキー：プログラムがサービスを呼ぶときの合い言葉です。人に見せない、コードに直接書かない、が基本です。
• 環境変数：OSやシェルに設定しておく名前つきの値です。プログラムが起動時に読めます。
• SDK：APIを呼ぶ部品です。RunwayはNode用とPython用を出しています。
• 開発者ポータル（Developer Portal）：APIのキーや請求を管理するサイトです。
• タスク（task）：生成を頼んだときの受付です。SDKには、できあがるまで待つ関数があります。
• プラグイン／パネル：編集ソフトの中に出る、Runwayの操作の窓です。

連携3：Runway API と公式SDK（プログラムから使う）

3-1. 開発者ポータルでキーをつくる

公式Docs「API Setup & Configuration」の手順です。

1. 開発者ポータル（公式Docsは https://dev.runway.com/ と書く）でアカウントをつくる。サインアップのあと、新しいプロジェクトをつくるか聞かれる。プロジェクトは、自分の連携ひとつぶんで、APIキーと設定を持つ。
2. API Keys のタブを開き、新しいキーをつくって、分かりやすい名前を付ける。キーをつくる・無効にするには、AdminかDeveloperの役割が要る。
3. キーは1回しか表示されない。パスワードマネージャーなどに写しておく。なくしたら、無効にして新しくつくる。
4. 開発者ポータルの請求のタブ（billing）で、プロジェクトにクレジットを足す。最低は$10（1クレジット$0.01）。足すには、AdminかBilling adminの役割が要る。
5. 環境変数 RUNWAYML_API_SECRET にキーを入れる。

export RUNWAYML_API_SECRET="<YOUR_API_KEY>"

• キーの実値は書かず、<YOUR_API_KEY> に自分のキーを入れてください。公式Docsの例は、key_ で始まる形の見本を載せています。
• 公式Docsのこの項目は、macOSとLinuxの例が出ます。Windowsのタブは、読んだときには内容が出ていませんでした（Windowsでの設定は、公式で確認してください）。
• 公式のアドレスの書き方に注意：Docsは開発者ポータルを dev.runway.com と書き、Dev MCPのURLは dev.runwayml.com です。01と03では dev.runwayml.com を挙げていました。どちらも公式ページに出てくるので、手元で開いて確かめてください。

3-2. キーの扱い（公式の注意）

• キーはプロジェクトのもので、人のものではありません。人をプロジェクトから外しても、そのキーは自動では止まりません。止めるには、キーを無効にします。
• 本番のコードに、キーを直接書かないこと。環境変数や、シークレットの管理の仕組みから読むこと、と公式Docsは書いています。
• 回転（rotate）や削除の手順としては、公式Docsに書かれているのは「無効にして、新しくつくる」だけです。

3-3. SDKを入れる

• どちらのライセンスも Apache-2.0 と書かれています。
• 公式Docsのトップは、SDKの入れ方は「SDKのページ」（docs.dev.runwayml.com/api-details/sdks/）を見るよう案内しています。

3-4. 最初の1回（公式READMEの例）

公式のNode SDKのREADMEが載せている例です（公式の写し）。

import RunwayML from '@runwayml/sdk';

const client = new RunwayML({
  apiKey: process.env['RUNWAYML_API_SECRET'], // This is the default and can be omitted
});

const imageToVideo = await client.imageToVideo.create({
  model: 'gen4_turbo',
  promptImage: 'https://example.com/assets/bunny.jpg',
  ratio: '1280:720',
  promptText: 'The bunny is eating a carrot',
});

console.log(imageToVideo.id);

Python SDKのREADMEの例です（公式の写し）。

import os
from runwayml import RunwayML

client = RunwayML(
    api_key=os.environ.get("RUNWAYML_API_SECRET"),  # This is the default and can be omitted
)

image_to_video = client.image_to_video.create(
    model="gen4_turbo",
    prompt_image="https://example.com/assets/bunny.jpg",
    ratio="1280:720",
    prompt_text="The bunny is eating a carrot",
)
print(image_to_video.id)

• どちらも、タスクを1つ受け付けてもらい、その番号（id）を出す例です。動画ができるまで待つ書き方ではありません。
• モデルの識別子は、時期で入れ替わります。03には、公式のAPI変更履歴が2026年7月30日に gen3a_turbo と gen4_aleph が使えなくなったと書いている、とまとめてあります（この記事では変更履歴を読み直していません）。READMEの gen4_turbo が今も使えるかどうかは、最新のモデル一覧で確かめてください。

3-5. 出力ができるまで待つ

公式Docs「Using the API」は、SDKに、できあがるまで待つ関数があると書いています。

• Node：waitForTaskOutput()、Python：wait_for_task_output()
• 公式Docs「Using the API」の例は、create() の戻り値に続けて waitForTaskOutput()（Python は wait_for_task_output()）をつなぐ形です。Node・PythonのSDKのREADMEのこの範囲には、この関数の記載は見つかりませんでした。
• 失敗すると TaskFailedError が上がり、詳細は taskDetails（Python では task_details）にある。
• できた出力のURLは、task.output[0] から読む。
• 公式Docsのトップの「クイックスタート」は、モデル gen4.5 で、テキストから動画のタスクをつくり、待って、動画のURLを出す例を載せています。ただし取得した結果ではPythonのコードのインデント（字下げ）が崩れて、importも抜けていたため、この記事では写しません。全文は公式ページで確認してください。

この記事で組んだ形の例です（公式の記載の用語に合わせて組んだもので、動作は確かめていません。モデル名やパラメーターは最新の資料で確かめてください）。

// Node.js（この記事の案）
import RunwayML, { TaskFailedError } from '@runwayml/sdk';

const client = new RunwayML(); // 環境変数 RUNWAYML_API_SECRET を読む

try {
  const task = await client.imageToVideo
    .create({
      model: 'gen4.5',
      promptText: '朝の海辺を歩く犬',
      ratio: '1280:720',
      duration: 5,
    })
    .waitForTaskOutput();
  console.log(task.output[0]);
} catch (error) {
  if (error instanceof TaskFailedError) {
    console.error(error.taskDetails);
  } else {
    throw error;
  }
}

3-6. 直接HTTPで呼ぶときの要点（公式Docs）

• 参照画像の tag は、promptText の中で @tag の形で呼べる、と書かれています。
• 公式Docsは、タスクの状態を調べるエンドポイントと、状態の値を、このページには載せていません。APIリファレンス（docs.dev.runwayml.com/api）を見るよう読めます。この記事では読んでいません。
• 公式Docsのコードの例は、取得した結果で、誤りが見つかっています（変数名の食い違い、カンマの抜け、importの抜けなど）。コードをそのまま写すのではなく、公式ページの最新の表記で確かめてください。

3-7. 入力（画像・動画・音声）の渡し方

公式Docsの入力のページ（docs.dev.runwayml.com/assets/inputs）の内容です。

• ファイルの種類：画像はJPEG、PNG、WebP（GIFは不可）。動画はMP4、MOV、MKV、WebMなど。音声はMP3、WAV、FLAC、M4A、AAC。ファイルの拡張子ではなくcontent typeで判断します。
• サイズの上限（URL／データURI）：画像は16MB／5MB、動画は32MB／16MB、音声は32MB／16MB。

一時アップロードの手順（公式Docs「アップロード」）：

1. POST /v1/uploads に、filename と type（値は "ephemeral"）を送る。ファイルの拡張子は中身と合わせる。
2. 応答に、uploadUrl、fields、runwayUri が返る。
3. uploadUrl にマルチパートで、fields と、ファイルの中身（file という項目）をPOSTする。
4. 成功したら、生成のリクエストに runwayUri を入れる。

5. 失敗したら、同じリクエストをやり直さず、新しく /v1/uploads から始める。

6. SDKでは、Nodeが client.uploads.createEphemeral、Pythonが client.uploads.create_ephemeral です。公式Docsのコードの例は、Pythonの Path のimportの抜けなどがあったため、この記事では写しません。

3-8. エラー・リトライ・タイムアウト（公式のREADME）

• Pythonは、AsyncRunwayML を使う非同期版もあります（READMEの記載）。

3-9. 利用の段階（Usage tiers）

公式Docsの表（確認日 2026-10-25）：

• 1日の生成の上限を超えると、タスクの作成が 429 で返ります。ローリングの24時間です。
• 同時実行の上限を超えた分は、THROTTLED の状態で待たされます。
• 1分あたりのリクエスト数の上限は、1日の上限の範囲なら、ないと書かれています。
• 1日の生成数は、モデルの種類で5つの値が並んでいます。どの値がどのモデルかは、公式の表に1対1の対応がなく、この記事では確認できていません。
• Enterpriseは、開発者ポータルの利用状況のページから、上限の例外を申請できる、と公式Docsのトップにあります。

3-10. 渡るデータ・外し方

連携4：編集ソフトのプラグイン

公式ヘルプ「Using the Runway Plugin in DaVinci Resolve」と「Using Runway Plugins in Adobe Premiere Pro」の内容です。

4-1. 共通の事実

• ダウンロードは、公式の plugin ページ（runway.com/plugins）。
• プラグイン自体は無料ですが、生成にはStandard以上のプランが要り、そのクレジットを使います。Freeでは、インストールとサインインまでできますが、生成はできません。
• サインインはブラウザで行い、パネルにパスワードは入れません。
• 複数のワークスペースに入っているときは、パネルの上のスイッチャーで選びます。選んだワークスペースが、生成の請求先になります。
• 生成はRunwayのサーバーで処理されるため、インターネット接続が必要です。結果は、Webのワークスペースにも出ます。
• 公式は、プラグインでの生成も、Webと同じ利用規約に従い、有料プランでは商用利用を含む、と書いています。

4-2. DaVinci Resolve

手順：

1. DaVinci Resolveを完全に終了する。
2. runway.com/plugins から、使っているOSのインストーラーをダウンロードする。macOSは .pkg、Windowsは .exe。どちらも管理者の許可が要る。
3. インストーラーを実行する。
4. Resolveを開き、Workspace → Workflow Integrations → Runway を選ぶ。パネルが別のウインドウで開く。
5. Sign in を選ぶ。ブラウザが開くので、Runwayにログインする。

できること（公式の記載）：画像と動画の生成、Edit Studio（Edit Video タブ。再生ヘッドの位置かイン・アウトの範囲を書き出し、Aleph 2で最大5つのキーフレームを使って再生成。前後の比較つき）、HDR変換を含む動画から動画の編集、背景の除去、アップスケール、生成の一覧（フィード）、Media Poolと開いているタイムラインの末尾への取り込み。

未対応（公式の記載）：アウトペインティング（Expand）、ProResと連番画像の取り込み、再生ヘッドの位置への取り込み、Linux、送信後の生成のキャンセル。ときどきセッションが切れて、もう一度のサインインが要ります。

更新：パネルにバナーが出たら、新しいインストーラーをダウンロードし、Resolveを終了してから開きなおします。

うまくいかないとき（公式の記載）

• 外し方（アンインストール、サインアウト）：公式ヘルプに記載が見つかりません。

4-3. Adobe Premiere Pro（とAfter Effects）

手順：

1. Premiere Pro（とAfter Effects）を完全に終了する。
2. インストーラーをダウンロードして実行する。
3. Premiere Proを開く。
4. Window → Extensions → Runway を選ぶ。
5. Sign in を選ぶ。ブラウザが開くので、Runwayにログインする。
6. 複数のワークスペースがあれば、パネルの上のスイッチャーで選ぶ。

できること（公式の記載）：画像の生成（背景、プレート、オーバーレイ、タイトルカードなど）、動画の生成（シーン、B-roll、インサート、カメラの動き。参照画像、開始フレーム、モデルごとの縦横比と長さの設定つき）、Edit Studio（選んだコンポのレイヤーからクリップを取り、タイムラインからアンカーのフレームを取って、Aleph 2で全体を再生成。最大5つのキーフレーム）、動画から動画（HDR変換を含む）、背景の除去、アップスケール、生成のフィード、コンプへの取り込み。

未対応（公式の記載）：アウトペインティング（Expand）、フィードからのドラッグ&ドロップ（クリックで取り込むと再生ヘッドの位置に入る）、送信後のキャンセル（最後まで走ってクレジットを使う）。

After Effects：同じインストーラーで、After Effectsにもパネルが入ります。After Effectsのサインインは、Premiere Proとは別です。ホストごとの詳細は、別の公式記事「Using Runway Plugins in Adobe After Effects」にあると案内されています（この記事では読んでいません）。

うまくいかないとき（公式の記載）

• 外し方（アンインストール、サインアウト）：公式ヘルプに記載が見つかりません。
• Premiere Proのセッションは、Premiere Proが自分で持っています。ときどき期限切れになり、サインインしなおす必要があります。

組み合わせの案（この記事の案。公式の手順ではありません）

ここは、上の公式の連携を、AI同士の組み合わせとして並べた、この記事の案です。動作は確かめていません。

• 生成用MCP（動画・画像をつくる）と、開発用MCP（APIの組み込みを手伝う）は、目的が違います。同じエディタに両方を入れても、名前（Runway と Runway Dev）で区別できるよう、公式の例は名前を分けています。
• コーディングAIにAPIのコードを書かせるときは、キーの実値をAIとの会話に貼らず、環境変数に入れて、コードからは process.env や os.environ で読む形にします（公式Docsが、環境変数から読むやり方を例に載せています）。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式のDocs、ヘルプ、GitHubのREADMEを読んだ範囲です。
• 公式ページ同士で書き方が違う所があります。開発者ポータルのアドレス（Docsは dev.runway.com、Dev MCPは dev.runwayml.com）など。手元で確かめてください。
• 「渡るデータ」「外し方」は、読んだ公式ページに書かれている範囲だけを載せています。書かれていないものは、書かれていないと書きました。
• キーの実値は、AIとの会話に貼らず、コードに直接書かないでください。公式Docsも、環境変数やシークレットの管理の仕組みから読むよう書いています。
• 公式Docsやヘルプの中には、コードの例に誤りや崩れが見つかったものがあります（Pythonの例のimportの抜け、字下げの崩れなど）。コードは、写す前に公式ページの原文を見てください。
• モデルの識別子、料金、プランの条件、上限は変わります。確認日は2026年10月25日です。
• 公式サイトの宣伝の数字や例は、会社自身の主張です。この記事では確かめていません。
• 契約や規約の解釈は、必要なら専門家や公式に確認してください。この記事は法律の助言ではありません。

出典

• API Setup & Configuration（Runway Dev Docs、Runway、確認日 2026-10-25）
• Using the API（Runway Dev Docs、Runway、確認日 2026-10-25）
• Runway Dev ドキュメント トップ（Runway Dev Docs、Runway、確認日 2026-10-25）
• Inputs（Runway Dev Docs、Runway、確認日 2026-10-25）
• Uploads（Runway Dev Docs、Runway、確認日 2026-10-25）
• API Usage Tiers & Limits（Runway Dev Docs、Runway、確認日 2026-10-25）
• Connect Runway Dev（Runway Dev Docs、Runway、確認日 2026-10-25）
• Connecting to Runway MCP（Runway Help Center、Runway、確認日 2026-10-25）
• runwayml/sdk-node（GitHub、Runway、確認日 2026-10-25）
• runwayml/sdk-python（GitHub、Runway、確認日 2026-10-25）
• Using the Runway Plugin in DaVinci Resolve（Runway Help Center、Runway、確認日 2026-10-25）
• Using Runway Plugins in Adobe Premiere Pro（Runway Help Center、Runway、確認日 2026-10-25）