Zum Hauptinhalt springen

paperoffice_voice_request

textstringrequired

Textinhalt, der vertont werden soll. Unterstützt Emotions-Markup wie (happy), (sad), (whispering).

Example: (happy)Sehr geehrter Herr Becker(laughing), vielen Dank für Ihre Nachricht...
voicestringrequired

Alias einer verfügbaren Stimme. Alias-Namen sind nicht case-sensitiv.

Example: Marlene
languagestring

Optionaler ISO-639-1 Sprachcode, wenn kein Voice-Alias verwendet wird.

Example: de
output_formatstring

Zielformat der Audiodatei.

Possible values: [mp3, wav, ogg]

Default value: mp3
prioritystring

Verarbeitungsmodus für den Job.

Possible values: [queue, stream]

Default value: queue
return_urlboolean

Bei true wird das Ergebnis direkt im Response-Body zurückgegeben.

Default value: false
gpuinteger

Ziel-GPU, falls mehrere Instanzen verfügbar sind.

Possible values: [0, 1]

speednumber<float>

Faktor zur Geschwindigkeitsanpassung. Werte ungleich 1 wirken sich auf die Qualität aus.

Possible values: >= 0.5 and <= 2

Default value: 1
temperaturenumber<float>

Variation der Stimmführung.

Possible values: >= 0.1 and <= 1

Default value: 0.95
top_pnumber<float>

Sampling-Parameter für Diversität.

Possible values: >= 0.1 and <= 1

Default value: 0.85
repetition_penaltynumber<float>

Unterdrückt Wiederholungen.

Possible values: >= 0.9 and <= 1.99

Default value: 1
reference_voicestring

Pfad zu einer Referenzdatei, falls kein Voice-Alias genutzt wird.

voice_typestring

Qualitätsstufe, wenn kein Voice-Alias gesetzt ist.

Possible values: [base, standard, premium]

Default value: base
genderstring

Wunschgeschlecht für die Sprecher:innenwahl in Kombination mit language.

Possible values: [male, female]

return_base64boolean

Liefert zusätzlich die Audiodaten als Base64-String.

Default value: false
paperoffice_voice_request
{
  "text": "(happy)Sehr geehrter Herr Becker(laughing), vielen Dank für Ihre Nachricht...",
  "voice": "Marlene",
  "language": "de",
  "output_format": "mp3",
  "priority": "queue",
  "return_url": false,
  "gpu": 0,
  "speed": 1,
  "temperature": 0.95,
  "top_p": 0.85,
  "repetition_penalty": 1,
  "reference_voice": "string",
  "voice_type": "base",
  "gender": "male",
  "return_base64": false
}