Zum Inhalt
HALOWERK

Medienwerk

tts

Takes a text and returns it spoken, as MP3, WAV, Opus, FLAC or raw linear16, encoded base64 with its media type and the resulting running time. The voice is chosen freely from the provider catalogue — over a hundred voices across languages and accents — and is validated against that catalogue before the request goes out, so a mistyped voice name comes back immediately with a list of near matches instead of a provider error.

POST https://medien.halowerk.com/v1/tts

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
textstringJaThe text to speak. At most 10000 characters per call.
voicestringNeinProvider voice name, e.g. aura-2-thalia-en, aura-2-agathe-fr. Checked against the provider catalogue before the request is sent. Aura-1 voices are billed at half the Aura-2 rate.
encodingstringNeinAudio format of the result.
include_audiobooleanNeinReturn the audio base64. Off returns only the figures — useful for checking the price and length first.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 10000,
      "description": "The text to speak. At most 10000 characters per call."
    },
    "voice": {
      "type": "string",
      "maxLength": 60,
      "default": "aura-2-thalia-en",
      "description": "Provider voice name, e.g. aura-2-thalia-en, aura-2-agathe-fr. Checked against the provider catalogue before the request is sent. Aura-1 voices are billed at half the Aura-2 rate."
    },
    "encoding": {
      "type": "string",
      "enum": [
        "mp3",
        "wav",
        "opus",
        "flac",
        "linear16"
      ],
      "default": "mp3",
      "description": "Audio format of the result."
    },
    "include_audio": {
      "type": "boolean",
      "default": true,
      "description": "Return the audio base64. Off returns only the figures — useful for checking the price and length first."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "text": "Der Vertrag laeuft zwoelf Monate und verlaengert sich automatisch, wenn er nicht fristgerecht gekuendigt wird.",
  "voice": "aura-2-thalia-en",
  "encoding": "mp3"
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →