Runwayは9月30日、開発者向けAPIにEleven v4を追加しました。リリースノートではモデルをeleven_v4と記載し、スクリプトを2,500文字までに制限するとともに、クレジット単価が2026年10月12日の太平洋時間に引き上げられるとしています。音声生成を本番ワークフローに組み込む開発者にとって重要なのは、有効なリクエストに何が必要で、文書化された料金がドル換算でいくらになるかです。本ガイドは10月6日に確認したRunwayの文書に基づいています。BIG CHANGEは有料API呼び出しを行っておらず、音声も評価していません。

大きな変化

  • 何が変わったか：Runwayは現在、既存のタスクAPIで使えるテキスト読み上げモデルとしてEleven v4を掲載しています。スクリプトには、文書に記載された音声タグ（[laughs]、[whispers]、[pause]など）を含めることができ、合計2,500文字以内に収める必要があります。
  • なぜ重要か：Runwayの開発者プロジェクトを持つチームは、プリセット音声で音声をリクエストし、完了したタスクの音声URLを取得できます。統合と予算計画には、文書化されたリクエスト形式と日付付きの料金表を利用できます。
  • 注目点：Runwayによると、料金は2026年10月12日の太平洋時間に、1,000文字あたり2.2クレジットから5クレジットに変わります。繰り返し生成する費用の見積もりには、リクエストが課金される時点の単価を使い、予算確定前に最新料金を確認してください。

プロジェクトとキーを設定する

Runwayの設定ガイドによると、開発者ポータルでアカウントとプロジェクトを作成し、次にAPI KeysでプロジェクトAPIキーを作成します。キーの作成または無効化にはAdminまたはDeveloperのロールが必要です。キーは平文で一度だけ表示されるため、安全に保管してください。SDKを使う場合、RunwayはRUNWAYML_API_SECRETを設定するよう案内しています。SDKはこの環境変数を自動的に読み取ります。秘密情報をソースコードに含めないでください。

APIを使うにはプロジェクトにクレジットも必要です。Runwayによると、初回の最低支払額は$10で、1クレジットあたり$0.01です。プロジェクトの請求タブから支払います。クレジットの追加にはAdminまたはBilling adminのロールが必要です。これは最低クレジット購入額であり、1回の音声リクエストの料金ではありません。設定ページには初回呼び出しが無料とは記載されていません。

テキスト読み上げリクエストを送信する

Runwayの現行Python SDKリクエスト型では、Eleven v4用のmodel、prompt_text、voiceオブジェクトが必須です。送信時のJSONフィールドはmodel、promptText、voiceで、voice.typeにはrunway-presetを設定し、presetIdを含めます。Bernardは掲載されているプリセットの1つです。SDKサービスはこのリクエストを/v1/text_to_speechにPOSTし、新しいタスクの応答を返します。RunwayのAPIガイドには、直接HTTP呼び出しで使うホスト、Bearerキー、X-Runway-Version: 2024-11-06ヘッダーが記載されています。

以下は文書から組み立てたリクエスト本文で、実際に送信した呼び出しではありません：

JSON
{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

Runwayの9月30日の変更履歴では、[laughs]、[whispers]、[pause]を対応例として挙げ、Eleven v4はEleven v3と同じRunwayプリセット音声を使うとしています。タグもスクリプトの一部なので、2,500文字の上限に収まるよう余裕を残してください。SDKには任意の音声設定、言語、隣接するテキスト欄もあります。スキーマから特定の設定が特定の話し方を保証するとは言えず、この記事も音声品質や遅延について主張していません。

最初の応答は音声データではなくタスクです。Runwayの出力ガイドはGET /v1/tasks/:idを照会するよう案内しています。成功したタスクには結果URLのoutput配列があります。APIにアクセスした時点から24～48時間でURLは期限切れになるため、製品内で一時URLを使わず、結果を自分のストレージにダウンロードしてください。一般的な出力例は動画タスクで、タスク応答の形式を示しています。一方、モデル一覧ではEleven v4の出力を音声としています。Eleven v4の応答を実際に確認したことはなく、音声ファイル形式も検証していません。

日付付き料金を計算する

Runwayの料金ページとリリースノートには、太平洋時間2026年10月12日までは1,000文字あたり2.2クレジット、以降は1,000文字あたり5クレジット、最低1クレジットと記載されています。公表されている1クレジット$0.01で換算すると、それぞれ$0.022、1,000文字あたり$0.05です。適用される税金は含みません。後の料金は前の料金の約2.27倍です。

透明性のある計画例として、課金対象がちょうど1,000文字のスクリプトを10本別々に送ると、合計10,000文字になります。公表料金で計算すると、従来の単価では22クレジット、つまり$0.22、引き上げ後は50クレジット、つまり$0.50です。各スクリプトは2,500文字の上限を下回り、計算上の各リクエスト料金は1クレジットの最低額を上回ります。これはRunwayの掲載料金に基づく算術計算で、実際の請求書ではありません。引用ページにはタグを課金文字数にどう含めるか、小数のリクエスト料金を丸めるかが記載されていません。本番の見積もりでは実際の使用記録と最新条件を確認してください。

出典と参考資料

Runwayの9月30日API変更履歴は、リリース日、モデルID、タグ例、スクリプト上限、日付付き料金の説明を示しています。設定ガイドには、プロジェクト、キー、クレジットの前提条件、ロール権限、初回$10の支払いが記載されています。料金ページにはクレジットとドルの換算、および掲載されているEleven v4料金があります。

このPython SDKリクエストスキーマとサービス実装を確認し、本文のフィールド名、プリセット音声の形式、エンドポイントのパス、タスク作成時の応答を特定しました。Runwayのスタートガイド、モデル一覧、出力ガイドにはHTTPバージョンヘッダー、音声出力の分類、タスク取得の動作が記載されています。これらは提供元の文書であり、独立した性能テストではありません。2026年10月6日確認。