Ses ve gerçek zamanlı

Konuşma Oluştur

Girdi metninden ses üretir

POST
/v1/audio/speech

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.

modelstringzorunlu

TTS model kimliği. Mevcut seçenekleri GET /v1/models?recommended_for=tts ile bulabilirsiniz. Varsayılan bir model yoktur.

inputstringzorunlu

Ses üretilecek metin. Maksimum 4096 karakterdir; bir model daha düşük bir sınır belirleyebilir, ayrıntılarına bakın.

voicestring | object

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.

voice_idstring

speech-2.8-turbo gibi bu parametreyi listeleyen modeller için ses kimliği.

instructionsstring

Bu parametreyi listeleyen modeller için 2000 karaktere kadar isteğe bağlı stil veya tonlama talimatları.

promptstring

qwen3-tts-1-7b-voicedesign gibi bu parametreyi listeleyen modeller için 2000 karaktere kadar isteğe bağlı konuşma stili istemi.

language_codestring

Destekleyen modeller için en-US gibi dil kodu.

response_formatstring

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.

stream_formatstringvarsayılan: audio

TokenLab iletim formatı: audio veya sse. sse değerini yalnızca model ayrıntılarında listelendiğinde gönderin.

speednumber

Destekleyen modeller için konuşma hızı. TokenLab 0.25 ile 4.0 arasını kabul eder; bir model bu aralığı daraltabilir.

temperaturenumber

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.mp3

Ses Ö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 örneği

Yanıt

200 OK
<binary audio data>

Önemli alanlar

Content-Typestring

HTTP yanıtı medya türü: ses formatı veya SSE için text/event-stream.

bodybinary | SSE

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
AuthorizationBearer <token>

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

X-TokenLab-Delivery-Policy?string

İ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