Ses ve gerçek zamanlı
Konuşma Oluştur
Girdi metninden ses üretir
Mevcut konuşma modellerini almak için GET /v1/models?recommended_for=tts kullanın.
İstek Gövdesi
Yanıt modu, seçilen modele ve stream_format değerine bağlıdır. Daha uzun girdiler için en az 120s HTTP istemci zaman aşımına izin verin.
İsteğe bağlı alanlar, sesler, çıktı formatları ve SSE desteği seçilen modele bağlıdır. Bunları göndermeden önce GET /v1/models/{model} uç noktasını kontrol edin. Desteklenmeyen parametreler 400 unsupported_parameter döndürebilir.
TTS model kimliği. Mevcut seçenekleri GET /v1/models?recommended_for=tts ile bulabilirsiniz. Varsayılan bir model yoktur.
Ses üretilecek metin. Maksimum 4096 karakterdir; bir model daha düşük bir sınır belirleyebilir, ayrıntılarına bakın.
Ses seçici. grok-tts için eve gibi model ayrıntılarındaki bir ses adını veya ses kimliklerini kabul eden modeller için { "id": "voice-id" } gibi bir nesne iletin.
speech-2.8-turbo gibi bu parametreyi listeleyen modeller için ses kimliği.
Bu parametreyi listeleyen modeller için 2000 karaktere kadar isteğe bağlı stil veya tonlama talimatları.
qwen3-tts-1-7b-voicedesign gibi bu parametreyi listeleyen modeller için 2000 karaktere kadar isteğe bağlı konuşma stili istemi.
Destekleyen modeller için en-US gibi dil kodu.
Ses formatı. Kabul edilen değerler modele bağlıdır: örneğin grok-tts yalnızca mp3 döndürürken qwen3-tts-flash wav döndürür. Bir değer göndermeden önce modelin ayrıntılarını kontrol edin.
audioTokenLab iletim formatı: audio veya sse. sse değerini yalnızca model ayrıntılarında listelendiğinde gönderin.
Destekleyen modeller için konuşma hızı. TokenLab 0.25 ile 4.0 arasını kabul eder; bir model bu aralığı daraltabilir.
Bu parametreyi listeleyen modeller için 0 ile 2 arasında örnekleme sıcaklığı (sampling temperature).
Yanıt
stream_format=audio ile yanıt ses baytlarını içerir. stream_format=sse desteği olan modeller bir text/event-stream yanıtı döndürür; tüm yanıtı bir ses dosyası olarak kaydetmek yerine olaylarını ayrıştırın.
İstek
curl -X POST "https://api.tokenlab.sh/v1/audio/speech" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-tts",
"voice": "eve",
"input": "Hello, welcome to TokenLab!"
}' \
--output speech.mp3Ses Örnekleri
Sesler modele bağlıdır. Birini göndermeden önce GET /v1/models/{model} üzerinden model ayrıntılarındaki voice değerlerini okuyun. Örneğin, grok-tts modeli eve, ara, rex, sal ve leo değerlerini kabul eder.
Yanıt
<binary audio data>Önemli alanlar
HTTP yanıtı medya türü: ses formatı veya SSE için text/event-stream.
audio için ses baytları; sse için bir olay akışı (event stream). Ayrıştırıcıyı Content-Type ve istenen modu kullanarak seçin.
MiniMax Speech 2.8 Turbo, seçilen bir seste hız odaklı bir iş akışıyla metni sentezler; duyarlı sesli arayüzler ve seslendirme için kullanışlıdır.
{
"model": "speech-2.8-turbo",
"input": "Welcome to TokenLab.",
"voice_id": "male-qn-qingse",
"speed": 1,
"response_format": "mp3",
"stream_format": "audio"
}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json