Audio

Ses uç noktaları üç işlem sunar: metinden sese (TTS), sesten metne (STT) ve sesten İngilizceye çeviri.

Metinden sese (TTS)

POST/v1/audio/speech

Metni seslendirilmiş bir ses dosyasına çevirir.

İstek parametreleri (JSON)

Alan	Tip	Zorunlu	Açıklama
model	string	✓	TTS modeli (örn. blab-tts)
input	string	✓	Seslendirilecek metin
voice	string	✓	Ses adı
response_format	string		mp3 (varsayılan), opus, aac, flac
speed	number		0.25–4.0 arası hız
stream_format	string		Akışlı çıktı için

Örnek

curl

curl https://app.qevron.ai/v1/audio/speech \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "blab-tts",
    "input": "Merhaba, bu Qevron ile üretilmiş bir sestir.",
    "voice": "naz"
  }' --output cikti.mp3

Python

resp = client.audio.speech.create(
    model="blab-tts",
    input="Merhaba, bu Qevron ile üretilmiş bir sestir.",
    voice="naz",
)
resp.stream_to_file("cikti.mp3")

Yanıt, ikili (binary) ses verisidir (örn. Content-Type: audio/mpeg). Akış kullanırsanız ses parçaları SSE olarak speech.audio.delta olayları hâlinde gelir.

Sesten metne (STT)

POST/v1/audio/transcriptions

Bir ses dosyasını metne döker. multipart/form-data kullanır.

Form alanları

Alan	Tip	Zorunlu	Açıklama
model	string	✓	STT modeli (örn. solab-stt)
file	dosya	✓	Ses dosyası (wav, mp3, m4a, ...)
language	string		Dil kodu (örn. tr, en)
response_format	string		json (varsayılan), verbose_json, text

Örnek

curl

curl https://app.qevron.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -F "model=solab-stt" \
  -F "file=@kayit.wav" \
  -F "language=tr"

Python

with open("kayit.wav", "rb") as f:
    resp = client.audio.transcriptions.create(
        model="solab-stt",
        file=f,
        language="tr",
    )
print(resp.text)

Yanıt

{ "text": "Merhaba, bu bir test kaydıdır." }

verbose_json kullanırsanız ek olarak language, duration ve segments döner.

Sesten İngilizceye çeviri

POST/v1/audio/translations

Transcriptions ile aynı form alanlarını kullanır, ancak çıktı metni İngilizceye çevrilir. language alanı gerekmez.