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。实际 HTTP 请求中的对应 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 日。