Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# Runway Eleven v4 語音 API：請求格式與 10 月定價

> Runway 的 Eleven v4 語音 API 接受最長 2,500 個字元的腳本。本指南以文件為基礎，說明請求、任務結果、帳戶設定，以及 10 月 12 日的價格變動。

By BIG CHANGE Editorial

Published: 2026-10-06T06:30:01.909Z
Updated: 2026-10-06T06:30:01.909Z
Canonical: https://bigchange.ai/blog/runway-eleven-v4-text-to-speech-api-price-change

![Conceptual charcoal illustration of unbranded headphones resting beside a loose script sheet with abstract text strokes.](https://bigchange.ai/api/media/file/runway-eleven-script-audio-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. A written script and headphones represent text-to-speech; no API test or audio assessment is depicted.

Runway 於 9 月 30 日將 Eleven v4 加入其開發者 API。[發行說明](https://docs.dev.runwayml.com/api-details/api_changelog/)將該模型標示為`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 的[設定指南](https://docs.dev.runwayml.com/guides/setup/)建議先在開發者入口網站建立帳戶和專案，再於 API Keys 下建立專案 API 金鑰。建立或停用金鑰需要 Admin 或 Developer 角色。金鑰只會以明文顯示一次，請妥善保存。使用 SDK 時，Runway 建議設定`RUNWAYML_API_SECRET`；其 SDK 會自動讀取該環境變數。請勿將密鑰寫入原始碼。

專案也必須有點數才能使用 API。Runway 表示首次最低付款額為**$10**，每**$0.01**一點，可透過專案帳單分頁付款。新增點數需要 Admin 或 Billing admin 角色。這是最低點數購買額，並非單次語音請求費用。設定頁面並未說明首次呼叫免費。

## 傳送文字轉語音請求

Runway 的 [Python SDK 目前的請求類型](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py)要求提供`model`、`prompt_text`以及一個`voice`物件，以用於 Eleven v4。實際傳輸的 JSON 對應欄位為`model`、`promptText`和`voice`，其中`voice.type`設為`runway-preset`，並包含`presetId`。`Bernard`是列出的預設語音之一。[SDK 服務](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py)會將請求傳送至`/v1/text_to_speech`，並回傳新的任務回應。Runway 的[API 指南](https://docs.dev.runwayml.com/guides/using-the-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 日的[更新日誌](https://docs.dev.runwayml.com/api-details/api_changelog/)將`[laughs]`、`[whispers]`和`[pause]`列為支援範例，並表示 Eleven v4 使用與 Eleven v3 相同的 Runway 預設語音。標籤屬於腳本內容，必須計入 2,500 字元上限。SDK 也列出選用語音設定、語言和相鄰文字欄位。其結構描述無法證明任何設定都能保證特定表達效果，本文也不對語音品質或延遲作出判斷。

初始回應是任務，而非音訊位元組。Runway 的[輸出指南](https://docs.dev.runwayml.com/assets/outputs/)建議查詢`GET /v1/tasks/:id`；成功任務會包含結果 URL`output`陣列。呼叫 API 後，這些 URL 會在 24–48 小時內到期，因此應將結果下載到自己的儲存空間，而不要在產品中使用暫時 URL。一般輸出範例展示影片任務，說明任務回應格式；[模型清單](https://docs.dev.runwayml.com/guides/models/)則將 Eleven v4 的輸出標示為音訊。我們未曾觀察 Eleven v4 的回應，也未驗證其音訊檔案格式。

## 計算註明日期的價格

Runway 的[價格頁](https://docs.dev.runwayml.com/guides/pricing/)和發行說明列出：太平洋時間 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 更新日誌](https://docs.dev.runwayml.com/api-details/api_changelog/)確認發布日期、模型 ID、標籤範例、腳本上限和註明日期的價格說明。[設定指南](https://docs.dev.runwayml.com/guides/setup/)說明專案、金鑰和點數前置條件，包括角色權限和首次 $10 付款。[價格頁](https://docs.dev.runwayml.com/guides/pricing/)提供點數兌換美元的方式及列出的 Eleven v4 費率。

這份[Python SDK 請求結構](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py)和[服務實作](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py)確認本文查核的欄位名稱、預設語音結構、端點路徑及建立任務時的回應。Runway 的[入門指南](https://docs.dev.runwayml.com/guides/using-the-api/)、[模型清單](https://docs.dev.runwayml.com/guides/models/)和[輸出指南](https://docs.dev.runwayml.com/assets/outputs/)提供 HTTP 版本標頭、音訊輸出分類和任務查詢行為。這些是服務商文件，並非獨立效能測試。查核日期：2026 年 10 月 6 日。

## Sources

- [Runway Dev API 更新日誌：Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — Runway 9 月 30 日條目宣布 eleven_v4、2,500 字元腳本上限、三個音訊標籤範例、Runway 預設語音，以及 10 月 12 日（太平洋時間）從每 1,000 字元 2.2 點數調升至 5 點數、最低 1 點數的變動。該條目不能證明音訊品質或 BIG CHANGE 成功呼叫 API。
- [Runway Dev API 設定](https://docs.dev.runwayml.com/guides/setup/) — 說明帳戶、專案、API 金鑰和角色前置條件、SDK 密鑰環境變數，以及每點數 $0.01、首次最低 $10 的點數購買額。這些是服務商指示，並非本文實際測試的步驟。
- [Runway Dev API 價格](https://docs.dev.runwayml.com/guides/pricing/) — 列出 Eleven v4 兩種註明日期的點數費率，以及每點數 $0.01。文中的 $0.22 和 $0.50 範例是十筆 1,000 字元請求的算術計算，並非實際帳單；可能還需繳銷售稅。
- [Runway Python SDK：文字轉語音請求結構](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — 目前官方 SDK 主分支定義 ElevenV4 必要模型、promptText 別名，以及含 presetId 的 runway-preset 語音；清單中列有 Bernard。主分支可能變動，且本文未執行請求。
- [Runway Python SDK：文字轉語音服務](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — 目前官方 SDK 服務會將請求傳送至 /v1/text_to_speech，並回傳新的任務回應。這不能證明曾觀察到 Eleven v4 回應。
- [Runway Dev：使用 API](https://docs.dev.runwayml.com/guides/using-the-api/) — 說明 API 主機、Bearer 金鑰、X-Runway-Version 2024-11-06 標頭，以及生成範例中的任務 ID 格式。查核的範例並非 Eleven v4 呼叫。
- [Runway Dev：輸出格式](https://docs.dev.runwayml.com/assets/outputs/) — 說明 GET /v1/tasks/:id、成功任務的輸出 URL 陣列，以及 URL 會在 24–48 小時後到期。展示範例是影片任務，因此不據此推斷 Eleven v4 音訊格式。
- [Runway Dev：可用模型](https://docs.dev.runwayml.com/guides/models/) — 將 eleven_v4 列為文字輸入、音訊輸出。這是模型分類，並非獨立音訊檢查。