API-documentatie

Toespraak naar tekst

Audio overschrijven op tekst. Ondersteunt 99 talen met automatische detectie.

Verzoek om een instantie (multipart/form-data)

Respons

{
  "text": "Hello, this is a transcription test.",
  "language": "en",
  "duration": 3.5,
  "segments": [
    {
      "start": 0.0,
      "end": 1.8,
      "text": "Hello, this is",
      "speaker": "SPEAKER_00"
    },
    {
      "start": 1.8,
      "end": 3.5,
      "text": "a transcription test.",
      "speaker": "SPEAKER_00"
    }
  ]
}

Stemklonen

Spraak genereren in een gekloonde stem. Upload een referentie audio en tekst.

Verzoek om een instantie (multipart/form-data)

Respons

Geeft het audiobestand terug als binaire gegevens, hetzelfde als het TTS-eindpunt.

Spraakwisselaar

Converteer audio naar geluid als een andere stem. Upload bron audio en kies een doelstem.

Verzoek om een instantie (multipart/form-data)

Voorbeeldverzoek

curl -X POST https://api.tts.ai/v1/voice-convert/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "file=@source_audio.mp3" \
  -F "target_voice=af_bella" \
  -F "model=openvoice" \
  -o converted.wav

Respons

Geeft het geconverteerde audiobestand terug als binaire gegevens.

Spraakvertaling

Vertaal gesproken audio van de ene taal naar de andere. Combineert spraak-naar-tekst, vertaling, en tekst-tot-spraak in een enkele oproep.

Verzoek om een instantie (multipart/form-data)

Respons

{
  "original_text": "Hello, how are you?",
  "translated_text": "Hola, como estas?",
  "source_language": "en",
  "target_language": "es",
  "audio_url": "https://api.tts.ai/v1/results/translate_abc123.mp3",
  "credits_used": 5
}

Toespraak

Transformeer spraakstijl, emotie of levering met behoud van de inhoud. Nuttig voor het aanpassen van toon, pacing, en expressiefheid.

Verzoek om een instantie (multipart/form-data)

Respons

Geeft het getransformeerde audiobestand terug als binaire gegevens.

Audiogereedschappen

Audio processing eindpunten voor verbetering, vocale verwijdering, steel splitsen, en nog veel meer.

{
  "key": "C",
  "scale": "Major",
  "bpm": 120.0,
  "time_signature": "4/4",
  "camelot": "8B",
  "compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}

Spraakgesprek

Stuur audio of tekst en ontvang een AI reactie met gesynthetiseerde spraak.

Verzoek om een instantie (multipart/form-data of JSON)

Respons

{
  "conversation_id": "conv_abc123",
  "user_text": "What is the capital of France?",
  "ai_text": "The capital of France is Paris.",
  "audio_url": "https://api.tts.ai/v1/audio/tmp/resp_xyz.mp3",
  "credits_used": 3
}

Partij TTS

Stuur meerdere teksten voor parallelle TTS-generatie. Optioneel ontvangt u een webhook callback wanneer alle taken voltooid zijn.

Parameters

Respons

{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

Bespreking van de voortgang met GET /v1/tts/batch/result/?batch_id=abc123

Voice Inbedding

Een voice-inbedding van referentie-audio vooraf berekenen. Gebruik de returned embed_id in latere voice-kloonverzoeken voor bijna-instant-generatie.

Parameters

Respons

{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

Gezondheidscontrole

Controleer de GPU-serverstatus, geladen modellen en wachtrijgrootte. Er is geen authenticatie vereist. Gevangen gedurende 30 seconden.

Respons

{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

Lijstmodellen

Geeft een lijst van alle beschikbare modellen met hun mogelijkheden.

Respons

{
  "models": [
    {
      "id": "kokoro",
      "name": "Kokoro",
      "type": "tts",
      "tier": "standard",
      "languages": ["en", "ja", "ko", "zh", "fr"],
      "supports_cloning": false,
      "supports_streaming": true,
      "credits_per_1k_chars": 2
    },
    {
      "id": "chatterbox",
      "name": "Chatterbox",
      "type": "tts",
      "tier": "premium",
      "languages": ["en"],
      "supports_cloning": true,
      "supports_streaming": true,
      "credits_per_1k_chars": 4
    }
  ]
}

Lijst Stemmen

Geeft een lijst van alle beschikbare stemmen, optioneel gefilterd door model of taal.

Parameters opvragen

Respons

{
  "voices": [
    {
      "id": "af_bella",
      "name": "Bella",
      "model": "kokoro",
      "language": "en",
      "gender": "female",
      "preview_url": "https://api.tts.ai/v1/voices/preview/af_bella.mp3"
    }
  ],
  "total": 142
}

Ondertiteling (SRT / VTT) nieuw

Genereer gesynchroniseerde ondertitels voor elke voltooide TTS-taak. Runs Whisper uitlijning over de audio en geeft SRT of WebVTT terug. Resultaat wordt gecached op de schijf dus een tweede oproep voor dezelfde uuid is een disk read.

Parameters opvragen

curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

Woordenboek van de uitspraak nieuw

Vertel de TTS-engine hoe specifieke woorden uit te spreken. Bewaarde entries automatisch op elk TTS-verzoek dat u doet. 200-entry per-account limiet.

Verzoek om een instantie (POST)

# Save an entry
curl -X POST https://tts.ai/api/v1/pronunciations/ \
  -H "Authorization: Bearer sk-tts-..." \
  -H "Content-Type: application/json" \
  -d '{"word": "GIF", "replacement": "jiff"}'

# List your entries
curl https://tts.ai/api/v1/pronunciations/ -H "Authorization: Bearer sk-tts-..."

# Delete entry by id
curl -X DELETE "https://tts.ai/api/v1/pronunciations/?id=42" -H "Authorization: Bearer sk-tts-..."

U kunt ook per-request-overrides doorgeven zonder ze op te slaan, inclusief uitspraken op een /v1/tts/aanroep als object of een array (zie de TTS-eindpuntparams).

Artikel Verteller nieuw

Laat een enkele