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
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
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.

Başlık
Authorization: Bearer YOUR_API_KEY
API anahtarınızı hesap tablosu.

Ses Klonlama

POST /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

POST /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

POST /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ı