Stimme und TTS

curl -X GET "https://app.talkturo.com/api/tts-voices?provider=elevenlabs&accountId=acc_2f8k9m1q" \
  -H "Accept: application/json"

[
  {
    "id": "voice_01hzy7n4k2q8m3p6r9t1v5w8x",
    "provider": "elevenlabs",
    "voice_id": "EXAVITQu4vr4xnSDxMaL",
    "name": "Rachel",
    "description": "English female voice",
    "language": "en",
    "preview_url": "https://cdn.talkturo.com/voices/rachel-preview.mp3",
    "metadata": {
      "gender": "female",
      "accent": "us"
    },
    "voice_model": "eleven_multilingual_v2",
    "account_id": null,
    "voice_type": "system"
  },
  {
    "id": "voice_01hzy7q0n6b4d8f2j5k9m3p7r",
    "provider": "elevenlabs",
    "voice_id": "cln_8vkm2q4p9x1r6t3n",
    "name": "Sales Demo Voice",
    "description": "Custom cloned voice",
    "language": "de",
    "preview_url": "https://cdn.talkturo.com/voices/sales-demo-preview.mp3",
    "metadata": {
      "sample_count": 1
    },
    "voice_model": "eleven_multilingual_v2",
    "account_id": "acc_2f8k9m1q",
    "voice_type": "cloned"
  }
]

curl -X POST "https://app.talkturo.com/api/voice-cloning" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -b "sb-access-token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example" \
  --data '{
    "accountId": "acc_2f8k9m1q",
    "preferred_name": "Vertrieb DE",
    "language": "de",
    "audio_base64": "UklGRmQAAABXQVZFZm10IBAAAAABAAEAESsAACJWAAACABAAZGF0YQAAAAA=",
    "audio_mime_type": "audio/wav"
  }'

{
  "success": true,
  "voice": {
    "id": "voice_01hzy8d4w3m7n2p5q9r6t1v4x",
    "provider": "elevenlabs",
    "voice_id": "cln_b7m4p2x9r6t1q8v3",
    "name": "Vertrieb DE",
    "description": "Custom cloned voice",
    "language": "de",
    "preview_url": "https://cdn.talkturo.com/voices/vertrieb-de-preview.mp3",
    "metadata": {
      "sample_count": 1
    },
    "voice_model": "eleven_multilingual_v2",
    "account_id": "acc_2f8k9m1q",
    "voice_type": "cloned"
  }
}

{
  "error": "Invalid request body"
}

{
  "error": "Forbidden"
}

{
  "error": "Voice provider upstream error"
}

{
  "error": "Internal server error"
}

{
  "error": "Voice cloning service unavailable"
}

curl -X GET "https://app.talkturo.com/api/voice-providers/models?provider=elevenlabs" \
  -H "Accept: application/json"

[
  {
    "id": "eleven_multilingual_v2",
    "name": "Eleven Multilingual v2"
  },
  {
    "id": "eleven_turbo_v2_5",
    "name": "Eleven Turbo v2.5"
  }
]

curl -X GET "https://app.talkturo.com/api/voice-providers/voices?provider=elevenlabs" \
  -H "Accept: application/json"

[
  {
    "id": "EXAVITQu4vr4xnSDxMaL",
    "name": "Rachel"
  }
]

Voice- und TTS-Endpunkte

Diese Endpunkte listen verfügbare TTS-Stimmen auf, erstellen geklonte Stimmen aus Audioproben und geben die unterstützten Modelle eines Sprachanbieters zurück.

Endpunktübersicht

GET /api/tts-voices

Listet Systemstimmen und geklonte Stimmen auf, die für TTS verfügbar sind. Dieser Endpunkt erfordert keine Authentifizierung.

Query-Parameter

Antwortfelder

POST /api/voice-cloning

Erstellt eine benutzerdefinierte geklonte Stimme aus einer Audioaufnahme. Dieser Endpunkt akzeptiert nur authentifizierte Anfragen mit Session-Cookie.

Request-Body

Antwortfelder

GET /api/voice-providers/models

Gibt die TTS-Modelle zurück, die für einen bestimmten Sprachanbieter verfügbar sind. Dieser Endpunkt ist öffentlich.

Query-Parameter

Antwortfelder

GET /api/voice-providers/voices

Listet Stimmen direkt von einem Anbieter auf. Dieser Endpunkt ist veraltet und sollte nur für bestehende Integrationen verwendet werden.

Query-Parameter

Antwortfelder

Hinweise zu Authentifizierung und Verhalten

Die öffentlichen Endpunkte auf dieser Seite eignen sich für das Laden von Stimmenlisten und Modellkatalogen vor dem eigentlichen TTS-Aufruf. Der Endpunkt für das Stimmklonen erstellt dagegen eine accountgebundene Ressource und erfordert deshalb eine angemeldete Sitzung.

Wenn Sie von GET /api/voice-providers/voices migrieren, verwenden Sie GET /api/tts-voices als neue Standardquelle. Die neuere Route liefert zusätzliche Felder wie provider, voice_model, account_id und voice_type, sodass Sie Systemstimmen und geklonte Stimmen mit demselben Schema verarbeiten können.

Geklonte Stimmen auflisten

Rufen Sie geklonte Stimmen für ein bestimmtes Konto ab. Erfordert eine authentifizierte Sitzung und Kontomitgliedschaft.

Endpunkt

GET /api/voice-cloning

Query-Parameter

Antwortfelder

Geklonte Stimme löschen

Entfernen Sie eine geklonte Stimme anhand ihrer ID. Die Stimme wird sowohl aus Talkturo als auch vom Anbieter entfernt, sofern zutreffend.

Endpunkt

DELETE /api/voice-cloning/{voiceId}

Pfadparameter

Antwortfelder

Geklonte Stimme abrufen

Rufen Sie eine einzelne geklonte Stimme anhand ihrer ID ab.

Endpunkt

GET /api/voice-cloning/{voiceId}

Pfadparameter

Antwortfelder

Geklonte Stimme aktualisieren

Aktualisieren Sie ein oder mehrere Felder einer bestehenden geklonten Stimme.

Endpunkt

PATCH /api/voice-cloning/{voiceId}

Pfadparameter

Body-Parameter

Antwortfelder

Stimmvorschauen

Generieren Sie Vorschau-Audio für bestimmte TTS-Anbieter. Alle Vorschau-Endpunkte erfordern Session-Authentifizierung und geben eine Audio-Antwort oder eine URL zum generierten Vorschau-Audio zurück.

Jeder Vorschau-Endpunkt akzeptiert eine Stimmen-ID und Vorschautext im Request-Body, generiert eine kurze Audioprobe und gibt das Vorschau-Audio zurück. Verwenden Sie diese Endpunkte, um Benutzern das Anhören von Stimmen zu ermöglichen, bevor sie einem Assistenten zugewiesen werden.

Allgemeine Body-Parameter

Allgemeine Antwort

Verwandte Ressourcen