runway-dev-models

Runway Dev モデル

アプリケーションの既存のサーバーとユーザーフローに、モデルの直接エンドポイントを統合します。runway-dev がインストールされている場合は、アカウントの設定、認証情報の境界、共有 SDK に関するガイダンスを参照してください。

ワークフロー

1. アプリを調査し、ユーザーが入力を提供する場所と出力を利用する場所を特定します。Runway へのリクエストは、アプリのサーバー境界内で処理してください。
2. ユーザーまたは既存のアプリが明示的に選択したモデルを使用してください。モデルの選択が必要な場合や、現在のプロジェクトのアクセス権と制約が重要な場合は、該当するプロジェクトとエンドポイントについて Dev MCP の list_models を使用してください。プロジェクト ID を推測したり、モデル名からアクセス権を推定したりしないでください。 カタログの概要では、各エンドポイントが返す価格の単位と制約をそのまま保持し、モデル数を完全なレスポンスと照合してください。
3. https://docs.dev.runwayml.com/llms.txt と https://docs.dev.runwayml.com/api.md から、該当するエンドポイントの最新の正確なリファレンスを読み取ります。モデルによってフィールド、許容値、入力、出力は異なる場合があります。隣接するエンドポイントのスキーマを流用しないでください。
4. アプリの言語に対応する公式 SDK を使用してください。タスクを作成する呼び出しでは、create() のレスポンスを await せずに、waitForTaskOutput() または wait_for_task_output() をチェーンしてください。ドキュメントに記載されたタスクエラーを処理し、タスクを黙って再送信するのではなく、ユーザーがタスクを確認または復旧できるようにしてください。
5. 成功、読み込み、エラーの状態を既存のインターフェースに組み込みます。署名付き出力 URL は一時的なものとして扱い、アプリケーションで後からメディアを使用する必要がある場合は永続化してください。
6. 適切なローカル検証を実行します。ライブ生成には料金が発生します。依頼または承認があった場合に限り実行し、その直前に選択したプロジェクトのクレジット残高を確認してください。

入力と認証情報

HTTPS URL、データ URI、アップロード URI に関する最新の入力ドキュメントに従ってください。ブラウザーで選択されたファイルはアプリケーションのサーバーに送信し、SDK に記載されたアップロードフローを使用してください。ローカルファイルシステムのパスを API に渡したり、検証せずにクライアントから任意のリモート URL を受け入れたりしないでください。

RUNWAYML_API_SECRET は、プロジェクトで既存のシークレット管理の仕組みを使ってサーバー上に保管してください。ブラウザーのコードに公開したり、MCP の設定に記載したりしないでください。Dev MCP は別途 OAuth を使用します。

最新のドキュメント

• Runway Dev エージェントのコンテキスト
• モデル
• 入力
• 出力
• SDK のタスク待機とエラー