API belgelendirmesi
Speech to Speech AI'ı basit bir REST API ile uygulamalarınıza entegre edin.
Hızlı Başlama
Speech to Speech AI API ile 5 dakikada başla.
Temel URL
https://api.speechtospeechai.com/v1
1. Bir iş başlatın
Her araç, API anahtarınızla yapılan bir POST isteğidir. Yanıt ses değil, bir iş kimliğidir.
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. Sonucu sorgulayın
status değeri completed olana kadar işi birkaç saniyede bir sorgulayın, ardından result_url adresini indirin.
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
-H "Authorization: Bearer YOUR_API_KEY"
{"status": "completed", "result_url": "https://.../output.mp3"}
Kimlik doğrulama
Tüm API talepleri, API anahtarı aracılığıyla kimlik doğrulamasını gerektirir. Authorization başlık.
Authorization: Bearer YOUR_API_KEY
Ses Klonlama
/v1/voice-clone/
Bir metni kısa bir referans kaydındaki sesle seslendirin.
İstek Vücudu (çok parçalı/form-data)
| Parametreler | Tipi | Gerekir | Açıklama |
|---|---|---|---|
reference_audio |
file | Evet | Klonlanacak sesin kaydı (10-30 saniye önerilir, en fazla 60) |
text |
string | Evet | Bu sesle okunacak metin |
model |
string | Hayır. | chatterbox, openvoice, tortoise veya gpt-sovits |
language |
string | Hayır. | Dil kodu (varsayılan: en) |
Cevap
Bir iş kimliği (uuid). status değeri completed olana kadar GET /v1/speech/results/?uuid= adresini sorgulayın ve result_url adresini indirin.
Metinden Sese
/v1/tts/
Metinleri sesli konuşmaya dönüştür.
İstek Vücudu (çok parçalı/form-data)
| Parametreler | Tipi | Gerekir | Açıklama |
|---|---|---|---|
text |
string | Evet | Dönüştürülecek metin (en fazla 5000 karakter) |
model |
string | Hayır. | kokoro (varsayılan), piper, vits veya bark |
voice_id |
string | Hayır. | GET /v1/speech/voices/?model= ile alınan ses kimliği |
language |
string | Hayır. | Dil kodu (varsayılan: en) |
speed |
float | Hayır. | Hız çarpıcısı (0.5-2.0, varsayılan 1.0) |
format |
string | Hayır. | wav (varsayılan), mp3, ogg veya flac. SSML etiketleri sentezden önce kaldırılır. |
Cevap
Bir iş kimliği (uuid). status değeri completed olana kadar GET /v1/speech/results/?uuid= adresini sorgulayın ve result_url adresini indirin.
Konuşmadan Metne
/v1/transcribe/
Sesleri zaman damgalarıyla metinlere çevir.
İstek Vücudu (çok parçalı/form-data)
| Parametreler | Tipi | Gerekir | Açıklama |
|---|---|---|---|
file |
file | Evet | Çevirilecek ses/video dosyası |
model |
string | Hayır. | large-v3 (varsayılan) veya turbo |
language |
string | Hayır. | Dil kodu veya otomatik algılama için auto (varsayılan) |
enable_word_timestamps |
bool | Hayır. | Her kelimeye başlangıç ve bitiş zamanı ekler |
callback_url |
string | Hayır. | İş bittiğinde sonucu POST ile alan URL |
Cevap
Bir iş kimliği (uuid). status değeri completed olana kadar GET /v1/transcribe/results/?uuid= adresini sorgulayın; ardından yanıt text, language ve segments alanlarını içerir.
Mevcut Modeller
Metinden Sese Modelleri
| Model ID | Açıklama | En Uygun Olduğu Alanlar |
|---|---|---|
kokoro |
Hızlı çok dilli TTS | Genel kullanım, düşük gecikme |
piper |
Hafif çok dilli TTS (yalnızca ticari lisanslı sesler) | 11 dilde hızlı görüntüleme |
vits |
LJSpeech plus 108 VCTK İngilizce konuşanlar | İngilizce aksanlar |
bark |
Üretici TTS, 13 dilde 130 önayar | Çeşitli, ifadeli sunuş (yavaş) |
openvoice |
Ses klonlama ve isteğe bağlı ses dönüştürme | Chatterbox alternatifi |
chatterbox |
23 dilde sıfır örnekle ses klonlama; varsayılan ses dönüştürme modeli | Kısa bir örnekten klonlama |
Sesten Metne Modelleri
| Model ID | Açıklama | En Uygun Olduğu Alanlar |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | En yüksek doğruluk, çok dilli |
whisper-turbo |
Hız için optimize edilmiş Whisper | Hızlı transkripsiyon |
Hata Kodları
| Kod | Durum | Açıklama |
|---|---|---|
invalid_api_key |
401 | API anahtarı geçersiz veya eksik |
insufficient_credits |
402 | Bu işlem için yeterli kredi yok |
rate_limit_exceeded |
429 | Çok fazla talep |
invalid_request |
400 | Yanlış biçimlendirilmiş isteğin gövdesi |
model_not_found |
404 | İstenen model mevcut değil |
voice_not_found |
404 | İstenen ses mevcut değil |
file_too_large |
413 | Yüklenen dosya büyüklük sınırını aştı |
server_error |
500 | İç sunucu hatası |