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 -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 "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.
Authorization: Bearer YOUR_API_KEY
Stemklonen
/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
/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
/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 |