Runway 於 9 月 30 日將 Eleven v4 加入其開發者 API。發行說明將該模型標示為eleven_v4，腳本上限為 2,500 個字元，並表示點數費率將於太平洋時間 2026 年 10 月 12 日調漲。對於將語音生成加入正式工作流程的開發者，實際問題是有效請求需要哪些內容，以及文件所列費率換算成美元是多少。本指南根據 10 月 6 日查核的 Runway 文件；BIG CHANGE 未進行付費 API 呼叫，也未評估音訊。

重大變化

  • 有何變化：Runway 現在將 Eleven v4 列為既有任務 API 下的文字轉語音模型。腳本可包含文件列出的音訊標籤，例如[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，每$0.01一點，可透過專案帳單分頁付款。新增點數需要 Admin 或 Billing admin 角色。這是最低點數購買額，並非單次語音請求費用。設定頁面並未說明首次呼叫免費。

傳送文字轉語音請求

Runway 的 Python SDK 目前的請求類型要求提供model、prompt_text以及一個voice物件，以用於 Eleven v4。實際傳輸的 JSON 對應欄位為model、promptText和voice，其中voice.type設為runway-preset，並包含presetId。Bernard是列出的預設語音之一。SDK 服務會將請求傳送至/v1/text_to_speech，並回傳新的任務回應。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；成功任務會包含結果 URLoutput陣列。呼叫 API 後，這些 URL 會在 24–48 小時內到期，因此應將結果下載到自己的儲存空間，而不要在產品中使用暫時 URL。一般輸出範例展示影片任務，說明任務回應格式；模型清單則將 Eleven v4 的輸出標示為音訊。我們未曾觀察 Eleven v4 的回應，也未驗證其音訊檔案格式。

計算註明日期的價格

Runway 的價格頁和發行說明列出：太平洋時間 2026 年 10 月 12 日之前每 1,000 個字元 2.2 點數，之後每 1,000 個字元 5 點數，最低1 點數。依已公布的每點數 $0.01，兩種費率分別換算為$0.022及每 1,000 個字元 $0.05，尚未計入適用稅費。後續費率約為先前的 2.27 倍。

透明的規劃範例：十條各有恰好 1,000 個計費字元的腳本，合計 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 日。