Worder API

ビデオで本人確認済みで、サンプルが1つ以上ある音声を一覧します。

クエリパラメータ

レスポンス

{
  "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
}

音声から音声を生成します。そのボイスアクターの有効なサブスクリプションがある場合は、サブスクリプションから秒数が差し引かれます。ない場合は、アクターの1秒あたりの単価でクレジットが課金されます。

リクエストボディ（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
}

エラーコード