Skip to main content
POST
Rufen Sie eine Sprachausgabe Ihres Kontos ab, einschließlich Skript, Sprecheinstellungen, temporärer Audio-URL und verfügbarer Wortzeitmarkenzuordnung.

Authentifizierung und Berechtigungen

string
erforderlich
Senden Sie einen VoiceCheap-API-Schlüssel in diesem Header. Authorization: Bearer mit demselben API-Schlüssel wird ebenfalls unterstützt. OAuth-Zugriffstoken werden nur von MCP akzeptiert, nicht von diesem REST-Endpunkt.
Erforderliche Berechtigungen: tts:read. Ein aktives kostenpflichtiges Abonnement ist erforderlich. Berechtigungen ändern weder Teamrollen noch Ressourceneigentum, Medienguthaben oder Tariflimits.

Parameter

string
erforderlich
Von tts_generate oder tts_list zurückgegebene Verlaufs-ID.Muster: ^(free-)?[0-9a-f]{64}$.
Das folgende JSON Schema enthält die exakten Feldnamen, verschachtelten Typen, Standardwerte, Grenzen und akzeptierten Werte aus der Discovery. Zusätzliche feldübergreifende Regeln finden Sie in den Hinweisen zur Operation.

Anfragebeispiele

Ersetzen Sie die beispielhaften Ressourcenkennungen und Medienschlüssel durch Werte, die für Ihr Konto zurückgegeben wurden. Behalten Sie bei Wiederholungen derselben Mutation dieselbe Anfragekennung bei.

Antwort

Eine erfolgreiche erste Ausführung gibt HTTP 200 mit dem Ergebnis der Operation unter data zurück. Bei einer Wiederholung kann stattdessen der gespeicherte Anfragestatus zurückgegeben werden. Das Beispiel zeigt eine unterstützte Antwort, nicht alle optionalen Felder. Details zum eigenen Sprachverlauf, vollständige bearbeitbare und gesprochene Skripte, Einstellungen zur Sprechweise, temporäre Wiedergabe-URL und alle verfügbaren Wortzeitstempel.

Ergebnisfelder

Hinweise zur Operation

  • historyId muss aus 64 hexadezimalen Kleinbuchstaben und Ziffern bestehen, optional mit dem Präfix free-. Verwenden Sie die von tts_generate oder tts_list zurückgegebene Kennung.
  • Optionale Eigenschaften älterer Datensätze wie voiceName, voiceSource und sourceFileName können ausgelassen werden. Fehlendes instructions erhält standardmäßig eine leere Zeichenfolge, fehlendes speed den Wert 1 und fehlendes previewEndIndex den Wert null.
  • wordAlignment kann null sein. Dieser Abruf lädt die vorhandene zeitliche Zuordnung; verwenden Sie tts_align, um Zeitstempel vorzubereiten.
  • Ausgangszeichenindizes in wordAlignment beziehen sich auf spokenText, aus dem Tags zur Steuerung der Sprechweise entfernt wurden.
  • audioUrl ist temporär. Rufen Sie für eine neue Wiedergabe erneut tts_get oder für einen Download-Link tts_download auf.
  • Der Sprachausgabeverlauf und benutzerdefinierte Stimmen gehören dem authentifizierten Konto. Die Teamabrechnung gewährt keinen Zugriff auf die Sprachausgaben oder Stimmen anderer Mitglieder.

Nutzung

Jeder erfolgreiche Aufruf verbraucht einen monatlichen API/MCP-Aufruf. Zusätzlich gelten das Medienguthaben und die eigenen Generierungskontingente der Operation.

Fehler