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。实际 HTTP 请求中的对应 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 成功调用。
- [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 列为文本输入、音频输出。这是模型分类，并非对音频的独立检查。