Dokümantasyon

Speeko API'yi dakikalar içinde kullanmaya başlayın. Eksiksiz kılavuzlar ve referanslar.

Hızlı Başlangıç

Adım 1: API Anahtarı Alın

Kayıt olun ve API anahtarınızı alın.

sk-speeko-xxxxxxxxxxxxxxxx

Asenkron — Metin Seslendirme

Adım 2: İstek Gönderin

Metninizi /tts adresine POST edin. Yanıt hemen döner — ses arka planda oluşturulur.

curl -X POST https://api.speekoapp.com/api/v1/tts \
-H"X-API-Key: sk-speeko-xxxxxxxxxxxxxxxx" \
-d'{
"text": "Hello world",
"voice": "am_michael",
"filetype": "mp3"
}'

Adım 3: job_id Alın

Yanıt (202 Accepted), ilerlemeyi takip etmek için bir job_id ve status_url içerir.

{
"job_id": "b3a1f9c2-...",
"status": "pending",
"status_url": "/api/v1/tts/b3a1f9c2-...",
"download_url": "/api/v1/tts/b3a1f9c2-.../download"
}

Adım 4: Durumu Takip Edin ve İndirin

status_url'i durum "done" olana kadar poll edin, ardından tamamlanan sesi download_url'den indirin.

GET/api/v1/tts/{job_id}
→ { "status": "done", "download_url": "..." }

GETdownload_url→ audio file

Asenkron — Metinden Video

Adım 2: İşi Gönderin

Metninizi /tts-video adresine POST edin. Video oluşturmak daha uzun sürdüğü için yanıt hemen döner.

curl -X POST https://api.speekoapp.com/api/v1/tts-video \
-H"X-API-Key: sk-speeko-xxxxxxxxxxxxxxxx" \
-F"text=Hello world" \
-F"voice=am_michael"

Adım 3: job_id Alın

Yanıt (202 Accepted), ilerlemeyi takip etmek için bir job_id ve status_url içerir.

{
"job_id": "b3a1f9c2-...",
"status": "pending",
"status_url": "/api/v1/tts-video/b3a1f9c2-...",
"download_url": "/api/v1/tts-video/b3a1f9c2-.../download"
}

Adım 4: Durumu Takip Edin ve İndirin

status_url'i durum "done" olana kadar poll edin, ardından tamamlanan videoyu download_url'den indirin.

GET/api/v1/tts-video/{job_id}
→ { "status": "done", "download_url": "..." }

GETdownload_url→ video file

Kimlik Doğrulama

TTS ve video endpoint'leri, X-API-Key başlığı üzerinden bir API anahtarı kabul eder. Yalnızca panelden erişilen endpoint'ler (kullanım, anahtar yönetimi) ise panel oturumunuzdan gelen bir JWT Bearer token kullanır.

X-API-Key:sk-speeko-xxxxxxxxxxxxxxxx

API anahtarınızı API Anahtarı Al sayfasından alın. Gizli tutun ve frontend kodunda asla paylaşmayın.

API Referansı

Her endpoint, buradan çalıştırabileceğiniz canlı örneklerle.

Metin Seslendirme

Metinden konuşma oluştur

Check a TTS job's status

Metin Video

Video oluşturma işi gönder

Tek bir video işinin durumunu kontrol et

İş Listesi

İşlerinizi listele

Kullanım

Kullanım istatistikleri

Sesler

Kullanılabilir sesleri listele

Health

API durumunu kontrol et

Hatalar

400Geçersiz istek — zorunlu alanları ve değer aralıklarını kontrol edin.

401Kimlik bilgisi eksik veya geçersiz.

402Kredi yetersiz veya aylık harcama limiti doldu.

429Hız limiti aşıldı — Retry-After başlığına bakın.

500Bizim tarafımızda bir şeyler başarısız oldu — tekrar denemek güvenli.

Hız Limitleri ve Kotalar

Essential Plan

100

istek/dakika

Pro Plan

1,000

istek/dakika

Kurumsal

Özel

satışla iletişime geçin

Hız limiti başlıkları API yanıtlarına dahildir. Limitleri aşan istekler HTTP 429 döndürür.