Voice Go API

Tüm istekler HTTPS üzerinden aşağıdaki adrese yapılır. İstek gövdeleri JSON'dur (deşifrede dosya yüklerken multipart/form-data); seslendirme yanıtı doğrudan ses dosyasıdır.

https://www.voicego.net/api/v1

Her istekte API anahtarınızı Authorization başlığında gönderin. Anahtarlar vg_live_ ile başlar. Alternatif olarak X-API-Key başlığı da kabul edilir.

Authorization: Bearer vg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST/api/v1/tts

Metni seçtiğiniz sesle seslendirir ve ses dosyasını döndürür. Başarılı her istek, metnin karakter sayısı kadar aylık kotanızdan düşer.

Parametreler

curl -X POST https://www.voicego.net/api/v1/tts \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Şirketimizi aradığınız için teşekkür ederiz.",
    "voice": "yeliz",
    "format": "wav_8k"
  }' \
  --output anons.wav

Yanıt

Başarılı yanıt 200 durum koduyla ses dosyasının kendisidir (Content-Type: audio/mpeg ya da audio/wav). Yanıt başlıkları:

• X-Characters — Bu istekte kotadan düşen karakter sayısı
• X-Quota-Limit · X-Quota-Used · X-Quota-Remaining — Aylık kota, bu ayki kullanım ve kalan karakter

GET/api/v1/voices

Kullanabileceğiniz seslerin listesini döndürür. expressive: true olan HD seslerde duygu, talimat ve etiketler desteklenir.

curl https://www.voicego.net/api/v1/voices -H "Authorization: Bearer $VOICEGO_API_KEY"

{
  "voices": [
    {
      "id": "yeliz",
      "name": "Yeliz",
      "names": { "en": "Amelia", "es": "Julia" },
      "gender": "female",
      "language": "tr-TR",
      "quality": "hd",
      "expressive": true
    }
  ]
}

POST/api/v1/transcribe

Ses ya da video kaydını yazıya döker; konuşmacıları ayırır ve her bölümün başlangıç ve bitiş zamanını verir. Başarılı her istek, kaydın süresi kadar (saniye, yukarı yuvarlanır) aylık deşifre sürenizden düşer.

Dosyayı iki şekilde gönderebilirsiniz: 4 MB'a kadar dosyaları multipart/form-data ile "file" alanında doğrudan yükleyin; daha büyük dosyalar için JSON gövdede "url" alanında dosyanın indirilebilir https adresini (ör. depolama servisinizin süreli/imzalı bağlantısı) verin. MP3, WAV, M4A, OGG, FLAC, MP4, MOV, WEBM gibi yaygın ses ve video biçimleri desteklenir.

Parametreler

# 4 MB'a kadar dosya: doğrudan yükleme
curl -X POST https://www.voicego.net/api/v1/transcribe \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -F "file=@gorusme.mp3" \
  -F "language=tr" \
  -F "speakers=2"

# Büyük dosya: indirilebilir adres, SRT altyazı olarak
curl -X POST https://www.voicego.net/api/v1/transcribe \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://depo.ornek.com/egitim-videosu.mp4",
    "language": "tr",
    "format": "srt"
  }' \
  --output altyazi.srt

Yanıt

json biçiminde yanıt; txt ve srt biçimlerinde yanıt doğrudan metin dosyasıdır. Yanıt başlıkları:

• X-Billed-Seconds — Bu istekte deşifre sürenizden düşen saniye
• X-Transcription-Limit-Seconds · X-Transcription-Used-Seconds · X-Transcription-Remaining-Seconds — Aylık deşifre süresi, bu ayki kullanım ve kalan süre (saniye)

{
  "text": "Merhaba, Voice Go'ya hoş geldiniz. Teşekkürler, sizi dinliyorum.",
  "language": "tur",
  "duration_seconds": 6.84,
  "billed_seconds": 7,
  "speakers": ["speaker_1", "speaker_2"],
  "segments": [
    { "speaker": "speaker_1", "start": 0.12, "end": 2.9, "text": "Merhaba, Voice Go'ya hoş geldiniz." },
    { "speaker": "speaker_2", "start": 3.4, "end": 6.7, "text": "Teşekkürler, sizi dinliyorum." }
  ]
}

Kalan süreniz olduğu sürece istek kabul edilir ve kaydın tamamı deşifre edilir; kayıt kalan sürenizden uzunsa aradaki fark da kullanıma yansır. Uzun kayıtlarda yanıt birkaç dakika sürebilir; istemcinizin zaman aşımını en az 5 dakika yapın.

GET/api/v1/usage

Bu ayki karakter kotanızı, deşifre sürenizi, kullanımınızı ve kotanın yenileneceği tarihi döndürür. Kotalar stüdyoyla ortaktır ve her ayın 1'inde (UTC) yenilenir.

{
  "characters": { "limit": 500000, "used": 128450, "remaining": 371550 },
  "transcription_seconds": { "limit": 36000, "used": 5420, "remaining": 30580 },
  "period": { "resets_at": "2026-11-01T00:00:00.000Z" }
}

HD seslerde metnin içine etiket ekleyerek okumaya duraklama, fısıltı ya da gülme gibi ifadeler katabilirsiniz. Desteklemeyen seslerde etiketler okunmadan çıkarılır.

"text": "Kampanyamız başladı! [pause] Detaylar için bire basın."

Hatalar JSON olarak döner: { "error": { "code": "...", "message": "..." } }. Mesajlar İngilizcedir; kodu kullanarak kendi dilinizde gösterebilirsiniz.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Your monthly character quota has been used up."
  }
}

• İstek başına en fazla 2500 karakter.
• Anahtar başına dakikada en fazla 60 seslendirme ve 10 deşifre isteği. Aşılırsa 429 döner.
• Deşifrede doğrudan yüklemeler en fazla 4 MB; daha büyük dosyalar url ile gönderilir.
• Aylık karakter kotası ve deşifre süresi hesabınıza tanımlıdır; stüdyo ve API kullanımı aynı kotadan düşer.
• Kotanızı artırmak için hesap temsilcinize ulaşın.

• API anahtarınızı yalnızca sunucu tarafında kullanın; tarayıcı ya da mobil uygulama koduna koymayın.
• Anahtar sızdığını düşünüyorsanız bize bildirin; anahtarı hemen iptal edip yenisini veririz.
• Anahtarlar sistemimizde yalnızca şifrelenmiş özet olarak saklanır; biz de dahil kimse anahtarınızı göremez.
• Gönderdiğiniz metinler ve kayıtlar yalnızca ses üretmek ve deşifre etmek için işlenir, yapay zeka modellerini eğitmek için kullanılmaz.
• Deşifre için gönderilen kayıtlar ve deşifre sonuçları Voice Go sunucularında saklanmaz; sonuç yalnızca size yanıt olarak döner.