Worder API

列出已通过视频验证且至少有一个样本的声音。

查询参数

响应

{
  "voices": [
    {
      "id": "...",
      "name": "Professional Narrator",
      "language": "English (United States)",
      "accent": null,
      "voiceType": "MULTI_EMOTION",
      "descriptiveTags": ["deep", "warm", "professional"],
      "samples": [
        { "id": "...", "label": "normal" },
        { "id": "...", "label": "happy" },
        { "id": "...", "label": "angry" }
      ],
      "user": {
        "id": "...",
        "name": "Sarah Mitchell",
        "pricePerSecondCents": 5,
        "volumeDiscounts": [
          { "threshold": 3600, "discountPercent": 20 }
        ],
        "storefront": { "slug": "sarahmitchell" }
      }
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

用某个声音生成语音。如果您对该配音演员有有效订阅，秒数将从订阅中扣除；否则按该配音演员的每秒价格从您的额度中扣费。

请求体（JSON）

指令标签

用方括号把脚本的各部分括起来，标签名需与该声音的某个样本标签一致。Worder 会用匹配的样本生成每一段，再把音频拼接在一起。

"text": "[happy] Welcome to the show! [confident] Now let's talk business."

可用标签因声音而异——请查看 /api/v1/voices 返回的 samples[].label 字段。未加标签的文本使用您指定的 sample_id，或第一个样本。对于多情感声音，若标签与其任何样本都不匹配，将返回 422 并附上该声音的可用标签——不会生成任何内容，也不会扣费。使用 13 个标准标签编写的脚本可用于任何提供这些标签的声音。

停顿标签

在段落之间插入静音。以秒为单位指定时长（整数或小数，最大 30）。停顿之后的文本沿用前一个标签的风格。

"text": "[excited] Big news! [pause 2] [calm] But let's take it one step at a time."
"text": "[calm] Take a breath. [pause 1.5] Now continue."
"text": "[happy] Hola! [pausa 3] [calm] Ahora hablemos con calma."

[pause N] 和 [pausa N] 均受支持（适用于任何语言）。

强调标签

使用 [emphasize] 提高下一段的音量。它不会改变声音风格——使用的样本与前一个标签相同。[emphasize] 之后的文本沿用前一个标签的风格。

"text": "[calm] Take a deep breath. [emphasize] Now give it everything you've got!"

也支持：[emphasis]、[enfatizar]、[énfasis]。

发音覆盖

使用 {written|spoken} 控制特定词语的发音。TTS 引擎接收“spoken”（读音）部分；质量检查则与“written”（书面）部分比对。

"text": "{Pulse|Pols} es la energía que necesitas. {Nike|Naiki} también lo sabe."

适用于品牌名、外来词或 TTS 读错的专业术语。

分段要求

响应

{
  "audio_url": "https://...",
  "voice_id": "...",
  "sample_id": "...",
  "seconds_generated": 12,
  "cost_cents": 60,
  "charged_via": "credits",
  "subscription_id": null,
  "balance_cents": 9940
}

错误代码