Runway 動画API設定
Runwayは動画生成プラットフォームです。通常ChatboxにBase URLを入力して使うものではなく、Runwayプラットフォーム上でAPI Keyを作成し、公式SDKまたはHTTPリクエストを使って動画生成タスクを作成します。
公式情報 ダウンロードおよびドキュメントは公式サイトの情報に準拠します。
適した利用シーン
Text-to-VideoImage-to-Video非同期タスク公式SDK
まず動画タスクの流れを理解する
- API Keyを作成し、アカウントに動画APIの利用権限と残高があることを確認します。
- タスクの種類（テキストから動画、画像から動画、または公式ドキュメントで現在サポートされているその他の動画タスク）を選択します。
- タスク送信後、動画ファイルはすぐには取得できません。通常はまずタスクオブジェクトまたはタスクIDが返されます。
- タスクの完了を待ってから、出力URLの読み取りまたは結果のダウンロードを行います。
- 失敗した場合は、Keyだけでなくタスクのステータスとエラーの詳細をまず確認してください。
パラメータの準備
| 設定項目 | 入力方法 |
|---|---|
| API Key | Runwayの管理画面で作成。公式SDKはデフォルトで <code>RUNWAYML_API_SECRET</code> を読み込みます |
| Task | テキストから動画 / 画像から動画 |
| Prompt | 動画内容の説明 |
| Ratio / Size | 横向き、縦向き、または指定サイズ |
| Duration | 動画の長さ（秒数） |
| Status | タスクが完了するまでポーリング |
| 設定項目 | 説明 | 初心者向けのアドバイス |
|---|---|---|
| API Key | Runway APIへのリクエスト認証情報 | ローカルマシンまたはサーバーの環境変数にのみ保存し、変数名 RUNWAYML_API_SECRET を使用してください |
| Prompt | 動画内容の説明 | 最初は短めに書き、スタイルを確認してから詳細化してください |
| Image | 画像から動画を生成する際の開始画像 | 被写体がはっきりした鮮明な画像をアップロードしてください |
| Duration | 動画の秒数 | まずは短い秒数でコストと効果をテストしてください |
| Status | タスクステータス | 動画生成は非同期のため、完了するまで待つ必要があります。 |
SDKの例
Runwayの環境変数名
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYRunway Node.js タスクの例
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }動画プラットフォームのフィールドはモデルのバージョンとともに更新されます。ページの例は設定構造を理解するためのものであり、実際のフィールドは公式ドキュメントの最新バージョンに準拠してください。
| 現象 | 優先確認項目 | 対応策 |
|---|---|---|
| 送信後すぐに動画が返されない | タスクはまだキューに入っているか、生成中ではないか | 動画生成は非同期タスクです。ステータスが完了になるまで待ってから結果を取得してください。 |
| タスク失敗 | モデル名、アスペクト比、秒数、入力画像が現在のモデル要件を満たしているか | 返されたエラーの詳細に従ってパラメータを調整し、一度に多くの項目を変更しないようにしてください。 |
| 料金が想定より高い | 秒数、解像度、モデルのバージョン | まずは短い秒数と低コストのパラメータでテストし、その後に一括生成を行ってください |