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."

Доступные теги зависят от голоса — смотрите поле samples[].label в ответе /api/v1/voices. Текст без тегов использует указанный 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
}

Коды ошибок