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
}

오류 코드