API Worder

Elenca le voci verificate in video che hanno almeno un campione.

Parametri della query

Risposta

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

Genera la voce da una voce. Se hai un abbonamento attivo con quel doppiatore, i secondi vengono scalati dall'abbonamento. Altrimenti i tuoi crediti vengono addebitati alla tariffa al secondo del doppiatore.

Corpo della richiesta (JSON)

Indicazioni di regia

Racchiudi parti del copione tra parentesi quadre con il nome di un'indicazione che corrisponda a una delle etichette dei campioni della voce. Worder genera ogni sezione con il campione corrispondente, poi unisce l'audio.

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

Le indicazioni disponibili dipendono dalla voce: controlla il campo samples[].label restituito da /api/v1/voices. Il testo senza indicazione usa il sample_id che hai specificato, oppure il primo campione. Su una voce multi-emozione, un'indicazione che non corrisponde a nessun campione restituisce 422 con le indicazioni disponibili per quella voce: non viene generato né addebitato nulla. I copioni scritti con le 13 indicazioni standard funzionano su qualsiasi voce che le offre.

Tag di pausa

Inserisce silenzio tra le sezioni. Specifica la durata in secondi (intero o decimale, massimo 30). Il testo dopo una pausa continua nello stile dell'indicazione precedente.

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

Sono supportati sia [pause N] sia [pausa N] (in qualsiasi lingua).

Tag di enfasi

Usa [emphasize] per alzare il volume della sezione successiva. Non cambia lo stile della voce: usa lo stesso campione dell'indicazione precedente. Il testo dopo [emphasize] continua nello stile dell'indicazione precedente.

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

Supportati anche: [emphasis], [enfatizar], [énfasis].

Pronuncia personalizzata

Usa {written|spoken} per controllare la pronuncia di parole specifiche. Il motore TTS riceve la versione “spoken” (pronunciata); il controllo qualità confronta con la versione “written” (scritta).

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

Utile per nomi di marchi, parole straniere o termini tecnici che il TTS pronuncia male.

Requisiti delle sezioni

Risposta

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

Codici di errore