Medya kılavuzları

Ses ve gerçek zamanlı işlemler

Ses oluşturun, sesi metne dönüştürün, konuşmayı çevirin veya gerçek zamanlı bir oturum başlatın

Sonucun bir dosya veya metin olduğu durumlarda ses uç noktalarını kullanın. Canlı, çift yönlü bir ses deneyimi için gerçek zamanlı WebSocket uç noktasını kullanın.

Bir uç nokta seçin

İhtiyaçUç NoktaKullanım Durumu
Metinden sesePOST /v1/audio/speechMetinden bir ses dosyasına ihtiyacınız olduğunda.
TranskripsiyonPOST /v1/audio/transcriptionsBir ses dosyasından metne ihtiyacınız olduğunda.
Ses çevirisiPOST /v1/audio/translationsBir ses dosyasından çevrilmiş metne ihtiyacınız olduğunda.
Gerçek zamanlı WebSocketWS /v1/realtime?model={model}WebSocket üzerinden çift yönlü ses akışına ihtiyacınız olduğunda. Sade GET /v1/realtime yalnızca meta veri döndürür.

Bir model seçin

Mevcut model listesini sabit kodlamak (hard-coding) yerine okuyun. Bir soket açmadan önce seçilen modelin ayrıntılarını gerçek zamanlı destek açısından kontrol edin.

curl "https://api.tokenlab.sh/v1/models?recommended_for=tts" \
  -H "Authorization: Bearer sk-your-api-key"

curl "https://api.tokenlab.sh/v1/models?recommended_for=stt" \
  -H "Authorization: Bearer sk-your-api-key"

Ses istekleri

Speech (Konuşma), HTTP yanıtında ses döndürür. Transkripsiyon ve çeviri, nihai metni veya kabul edilmiş bir görevi döndürebilir. Gövde, nihai metin yerine bir görev kimliği (task ID) ve durum içerdiğinde, kimliği kaydedin ve tamamlanana veya başarısız olana kadar GET /v1/tasks/{id} uç noktasını sorgulayın (poll). Büyük dosyalar için yeterli zaman tanıyın ve Request ID'yi saklayın.

Ses sonucu URL'leri, 30 gün boyunca geçerli kalan TokenLab medya sonucu URL'leridir. media_retention.items, her öğenin kaydetme durumunu ve expires_at bilgisini raporlar; kaydetme durumu zamanında bilinmediğinde yanıt media_retention bilgisini içermeyebilir ancak URL yine de çalışır. Satır içi veya ikili (binary) ses yanıtları bu URL kopyalama saklama kapsamının dışındadır. Bkz: Veri saklama.

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": "Welcome to TokenLab."
  }' \
  --output speech.mp3

Gerçek zamanlı oturumlar

Sorgu dizesinde model ve Authorization başlığında API anahtarı ile bir WebSocket açın. Seçilen gerçek zamanlı model için belgelenmiş olay formatını koruyun ve oturum tamamlandığında soketi kapatın.

Bir oturum en fazla 1 saat sürer. Ardından sunucu, 1000 kodu ve session_timeout nedeni ile soketi kapatır. Tek bir mesaj 32 MiB'a kadar olabilir; daha büyük bir mesaj soketi 1009 kodu ile kapatır. grok-voice-think-fast-2.0 gibi bazı gerçek zamanlı modeller yalnızca ses karelerini ve oturum güncellemelerini kabul eder. Metin girişi öğesi unsupported_realtime_text_input hatasını döndürür ve soketi 1008 kodu ile kapatır.

Bu kılavuz yalnızca WebSocket alt kümesini kapsar. TokenLab şu anda OpenAI Realtime REST istemci sırrı, çeviri istemci sırrı, Çağrılar veya eski beta oturum yönetimi uç noktaları sağlamamaktadır.

Aşağıdaki sunucu tarafı örneği için ws paketini yükleyin ve TOKENLAB_REALTIME_MODEL değişkenini, ayrıntılarında /v1/realtime bildiren güncel bir modele ayarlayın. Sunucu ortamında TOKENLAB_API_KEY sağlayın; yalnızca ismin varlığı gerçek zamanlı desteği oluşturmaz.

npm install ws
import WebSocket from 'ws';

const model = process.env.TOKENLAB_REALTIME_MODEL;
const apiKey = process.env.TOKENLAB_API_KEY;
if (!model || !apiKey) throw new Error('Set TOKENLAB_REALTIME_MODEL and TOKENLAB_API_KEY');

const url = new URL('wss://api.tokenlab.sh/v1/realtime');
url.searchParams.set('model', model);
const socket = new WebSocket(url, {
  headers: { Authorization: `Bearer ${apiKey}` },
});
socket.on('message', (event) => console.log(event.toString()));
socket.on('error', (error) => console.error(error.message));
process.once('SIGINT', () => socket.close(1000, 'Client stopped'));

İlerlemeyi güvenli bir şekilde gösterin

  • Yenileme sırasında aynı isteği tekrar oynatmak yerine oluşturulan ses dosyalarını kaydedin.
  • Transkripsiyon ve çeviri için, API çağrısı senkron olsa bile yükleme ve işleme durumlarını gösterin.
  • Gerçek zamanlı işlemler için, kapatma olaylarını yönetin ve yalnızca kullanıcı yeni bir oturum başlattıktan sonra yeniden bağlanın.
  • Ses metni girişine API anahtarları, özel URL'ler veya hesap sırları koymayın.

API Referansı

KonuReferans
Konuşma OluşturmaKonuşma Oluşturma
Transkripsiyon OluşturmaTranskripsiyon Oluşturma
Çeviri OluşturmaÇeviri Oluşturma
Gerçek zamanlı WebSocketGerçek zamanlı WebSocket
Modelleri ListeleModelleri Listele
Faturalandırma ve FiyatlandırmaFaturalandırma ve Fiyatlandırma

Bu sayfada