通过 Speko 语音路由器调用 Paxa 文本转语音

一个调用多家语音服务商的语音应用,要为每一家分别编写请求格式、密钥和错误处理,还要让它们始终保持一致。

Speko 在 router.speko.dev 上运营托管的语音路由器,为其列出的所有服务商提供同一种请求格式,其目录以 provider paxa 收录了 Paxa 的 Paxa TTS Flash v2 (paxa-tts-flash-v2) 和 Paxa TTS Flash (paxa-tts-flash-v1)。

一个请求,指定 Paxa#

这是 Speko 文档中的语音合成请求,routing 对象指定为 provider paxa,第二个标签页是自动路由的写法。旁边是 Speko 文档列出的响应头,填入的是 Paxa 路由返回的值。

curl https://router.speko.dev/v1/tts/speech \
  -H "Authorization: Bearer $SPEKO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "routing": { "mode": "explicit", "provider": "paxa", "model": "paxa-tts-flash-v2" },
    "input": "พัสดุของคุณจัดส่งแล้ว และจะถึงในวันพฤหัสบดีค่ะ",
    "voice": "nomyen",
    "audio": { "encoding": "pcm_s16le", "sample_rate_hz": 24000, "channels": 1 }
  }' \
  --output speech.pcm

Speko 在路由文档中说明了两种路由模式。显式路由不会回退到其他服务商。

路由响应头

响应头值
Speko-Providerpaxa
Speko-Modelpaxa-tts-flash-v2
Speko-Request-ID把这段音频与 Speko 账单上对应条目关联起来的 ID

Speko 在语音合成接口页面列出了这些响应头。响应体是原始音频,编码由请求指定。

服务商 ID
paxa
由 Speko 计费
Speko 上的 Paxa 模型
2
paxa:paxa-tts-flash-v2paxa:paxa-tts-flash-v1
Speko 为 paxa-tts-flash-v1 列出的语言
英语、泰语

从 Speko 密钥到 Paxa 路由#

Speko 默认使用自己的服务商凭证调用 Paxa。以下步骤需要 Speko 账户,不需要 Paxa 密钥。

  1. 获取 Speko 密钥

    在 platform.speko.ai 的 Speko 控制台创建 API 密钥。每个请求都以 bearer token 的形式发送它,每个 POST 请求还要带上自己的 Idempotency-Key。

  2. 指定 Paxa 或自动路由

    把 routing 设为 explicit,并指定 provider paxa 和模型 paxa-tts-flash-v2 或 paxa-tts-flash-v1,每个请求都会到达 Paxa。设为 auto 并选择 balanced、quality、latency 或 cost 中的一个 objective,则由 Speko 选择服务商。

  3. 读取路由响应头

    Speko-Provider 和 Speko-Model 标明生成音频的服务商和模型。把 Speko-Request-ID 记入日志,就能把请求与账单条目对应起来。

Paxa TTS Flash v2 标价为每百万字符 $10。这是 Paxa 自有 API 的价格。通过 Speko 路由器的用量由 Speko 自行计费,详见其计费文档。

常见问题#

什么是语音路由器?

Speko 把自己的 Router 描述为托管服务,负责对 STT、LLM 和 TTS 进行托管路由。应用发送同一种请求格式,每个请求里的 routing 对象要么指定服务商和模型,要么让 Router 按 balanced、quality、latency 或 cost 这几种目标自行选择。

Speko 上有哪些 Paxa 模型?

Speko 在 provider paxa 下列出了 Paxa TTS Flash v2 (paxa-tts-flash-v2) 和 Paxa TTS Flash (paxa-tts-flash-v1),也就是 Paxa 自己的 API 提供的这两个模型。

可以直接调用 Paxa 吗?

可以。文本转语音页面介绍了 Paxa TTS Flash v2、Paxa TTS Flash 和全部音色,API 文档说明了请求、密钥以及每次调用消耗的积分。

Speko 能把泰语发给 Paxa 吗?

能。Speko 的目录为 paxa-tts-flash-v1 列出了英语和泰语,Paxa TTS Flash v2 的每个音色都能朗读中文、英语和泰语。泰语文本通过显式路由发往 provider paxa 时会到达 Paxa,Speko 不会换用其他服务商。

从免费积分开始

使用 Google、GitHub 或 Hugging Face 登录,即可用 100 一次性免费积分处理您自己的文本。