API-documentatie

Integreer Speech to Speech AI in je applicaties met een eenvoudige REST API.

Snelstart

Begin met de Speech to Speech AI API in minder dan 5 minuten.

Basis-URL
https://api.speechtospeechai.com/v1
1. Start een job

Elke tool is een POST met je API-sleutel. Het antwoord is een job-id, niet de audio.

cURL
curl -X POST https://api.speechtospeechai.com/v1/tts/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text=Hello! Welcome to Speech to Speech AI." \
  -F "model=kokoro" \
  -F "voice_id=af_heart" \
  -F "format=mp3"

{"uuid": "3f2c...", "job_id": "...", "status": "queued"}
2. Vraag het resultaat op

Vraag de job om de paar seconden op tot de status completed is en download dan result_url.

cURL
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
  -H "Authorization: Bearer YOUR_API_KEY"

{"status": "completed", "result_url": "https://.../output.mp3"}

Authenticatie

Alle API-verzoeken vereisen authenticatie via een API-sleutel in de Authorization kop.

Kop
Authorization: Bearer YOUR_API_KEY
Haal je API sleutel van je account dashboard.

Stemklonen

POST /v1/voice-clone/

Laat een tekst uitspreken met de stem van een korte referentieopname.

Verzoek om inlichtingen (multipart/form-data)
Parameter Type Vereist Omschrijving
reference_audio file Ja. Opname van de stem om te klonen (10-30 seconden aanbevolen, maximaal 60)
text string Ja. Tekst die met die stem wordt uitgesproken
model string Nee chatterbox, openvoice, tortoise of gpt-sovits
language string Nee Taalcode (standaard: en)
Respons

Een job-id (uuid). Vraag GET /v1/speech/results/?uuid= op tot status completed is en download result_url.

Tekst naar spraak

POST /v1/tts/

Tekst omzetten naar spraakaudio.

Verzoek om inlichtingen (multipart/form-data)
Parameter Type Vereist Omschrijving
text string Ja. Tekst om om te zetten (maximaal 5000 tekens)
model string Nee kokoro (standaard), piper, vits of bark
voice_id string Nee Stem-id uit GET /v1/speech/voices/?model=
language string Nee Taalcode (standaard: en)
speed float Nee Snelheidsmultiplicator (0,5-2,0, standaard 1,0)
format string Nee wav (standaard), mp3, ogg of flac. SSML-tags worden vóór de synthese verwijderd.
Respons

Een job-id (uuid). Vraag GET /v1/speech/results/?uuid= op tot status completed is en download result_url.

Toespraak naar tekst

POST /v1/transcribe/

Audio naar tekst met tijdstempels overschrijven.

Verzoek om inlichtingen (multipart/form-data)
Parameter Type Vereist Omschrijving
file file Ja. Audio/videobestand om te transcriberen
model string Nee large-v3 (standaard) of turbo
language string Nee Taalcode, of auto om die te herkennen (standaard)
enable_word_timestamps bool Nee Voegt aan elk woord een begin- en eindtijd toe
callback_url string Nee URL die het resultaat via POST ontvangt wanneer de job klaar is
Respons

Een job-id (uuid). Vraag GET /v1/transcribe/results/?uuid= op tot status completed is; het antwoord bevat dan text, language en segments.

Beschikbare modellen

Tekst-naar-spraakmodellen
Model ID Omschrijving Ideaal voor
kokoro Snelle meertalige TTS Algemeen gebruik, lage latentie
piper Lichtgewicht meertalige TTS (alleen commercieel gelicentieerde stemmen) Snelle weergaven in 11 talen
vits LJSpeech plus 108 VCTK Engelstaligen Engelse accenten
bark Generieve TTS, 130 presets in 13 talen Variatief, expressief aanbod (langzaam)
openvoice Stemklonen en optionele stemconversie Alternatief voor Chatterbox
chatterbox Zero-shot stemklonen in 23 talen; standaardmodel voor stemconversie Klonen van een kort monster
Spraak-naar-tekstmodellen
Model ID Omschrijving Ideaal voor
whisper-large-v3 OpenAI Whisper Large v3 Hoogste nauwkeurigheid, meertalig
whisper-turbo Geoptimaliseerde Whisper voor snelheid Snelle transcriptie

Foutcodes

Rubriek Status Omschrijving
invalid_api_key 401 Ongeldige of ontbrekende API-sleutel
insufficient_credits 402 Niet genoeg credits voor deze operatie
rate_limit_exceeded 429 Te veel verzoeken
invalid_request 400 Onjuiste verzoekinstantie
model_not_found 404 Model op verzoek bestaat niet
voice_not_found 404 De gevraagde stem bestaat niet
file_too_large 413 Geüpload bestand overschrijdt de limiet voor grootte
server_error 500 Interne serverfout