Dokümantasyon

API entegrasyonu ve kullanım kılavuzu

Hızlı Başlangıç

1. Hesap Oluşturun

Kayıt olun ve 50,000 ücretsiz kredi kazanın.

2. API Token Alın

Dashboard'dan API token'ınızı oluşturun.

3. İstek Gönderin

curl -X POST https://your-domain.com/api/tts/synthesize \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "tr",
    "text": "Merhaba dünya"
  }'

API Referansı

POST /auth/login

Kullanıcı girişi ve JWT token alımı

// Request
{
  "email": "user@example.com",
  "password": "your_password"
}

// Response
{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "credits": 50000,
  "plan": "Launch"
}

POST /tts/synthesize

Metin sentezleme (JWT gerekli)

// Request
{
  "language": "tr",  // tr, en, de, fr, es, pt
  "text": "Sentezlenecek metin",
  "voice": "default"
}

// Response
{
  "success": true,
  "audioBase64": "UklGRiQAAABXQVZF...",
  "characters": 21,
  "creditsRemaining": 49979
}

GET /credits/usage

Kredi kullanım bilgisi (JWT gerekli)

// Response
{
  "quota": 50000,
  "used": 1021,
  "remaining": 48979,
  "period": "2025-10",
  "nextReset": "otomatik dönem sonu"
}

Desteklenen Diller

Türkçe

Code: tr • Locale: tr-TR

English

Code: en • Locale: en-US

Deutsch

Code: de • Locale: de-DE

Français

Code: fr • Locale: fr-FR

Español

Code: es • Locale: es-ES

Português

Code: pt • Locale: pt-PT

Rate Limits

• API: 100 istek/dakika
• TTS Synthesize: 2 dakika timeout
• Maksimum metin uzunluğu: 5,000 karakter
• Maksimum dosya boyutu: 20MB

HTTP Durum Kodları

200 OKİstek başarılı

400 Bad RequestGeçersiz istek

401 UnauthorizedJWT token gerekli

402 Payment RequiredYetersiz kredi

429 Too Many RequestsRate limit aşıldı

500 Internal Server ErrorSunucu hatası

504 Gateway TimeoutTTS worker zaman aşımı

← Ana Sayfaya Dön