OpenAI TTS API
RunAPI tarafından yönetilen MP3 çıktısıyla düşük gecikmeli ve yüksek kaliteli metinden sese üretim için OpenAI TTS API erişimi.
curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"text": "Bu ürün karşılama metnini uygulama içi tanıtım için net ve doğal bir seslendirmeye dönüştürün."
}'
import { OpenaiTtsClient } from "@runapi.ai/openai-tts";
const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
model: "tts-1-hd",
text: "Bu ürün karşılama metnini uygulama içi tanıtım için net ve doğal bir seslendirmeye dönüştürün.",
});
require "runapi/openai_tts"
client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
model: "tts-1-hd",
text: "Bu ürün karşılama metnini uygulama içi tanıtım için net ve doğal bir seslendirmeye dönüştürün."
)
npx skills add runapi-ai/openai-tts -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
OpenAI TTS, senkron bir RunAPI endpoint'i üzerinden metni sese dönüştürür. Gecikmeye duyarlı uygulamalar için tts-1 modelini, daha yüksek ses kalitesine sahip anlatım için tts-1-hd modelini seçin; ikisi de yönetilen bir MP3 URL'si döndürür.
- Farklı hız / kalite seviyeleri için birden çok varyant
- Model skill dokümanları, şemaları ve kurulum notlarını içerir
- Uygulama odaklı kodlama workflow’larıyla çalışır
- Başarısız üretimler ücretlendirilmez
Tüm API varyantlarını karşılaştırın
Uygulama geliştirme için OpenAI TTS skill’ini kurun
Model dokümanlarını, şemaları, fiyat notlarını ve kurulum adımlarını kod workspace’inize yükleyin.
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -g
Install the OpenAI TTS skill for this app: 1. Add runapi-ai/openai-tts with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Model skill’den ilk sonuca dört adımda
Modeli seçin
Çıktı tipi, kalite eşiği ve gecikme hedefinize uygun model ve varyantı seçin.
Yapılandır
RunAPI anahtarınızı ayarlayın ve model skill’i kod workspace’inize kurun.
Geliştirin
Skill talimatlarını kullanarak model özelliğini uygulamanızın içine ekleyin.
Al
Task ID ile sorgulayın, destekleniyorsa stream edin veya webhook callback’i işleyin.
OpenAI TTS API nedir?
OpenAI TTS, etkileşimli oynatma ve profesyonel anlatım için özel metinden sese modelleri sunar. RunAPI üzerinden iki varyant da aynı istek yapısını kullanır ve yönetilen ses meta verileri döndürür.
OpenAI TTS API neden RunAPI üzerinden kullanılmalı
Tek kimlik doğrulama, tüm sağlayıcılar
Tek bir RunAPI anahtarı tüm kataloğu açar. Ayrı hesap yok, her entegrasyon için anahtar döndürme yok.
Birleşik fiyatlandırma ve faturalandırma
USD bazında çağrı başı fiyatlandırma, aylık faturalandırılır. Başarısız üretimler ücretlendirilmez.
Şemalı skill
Tipli şemalar ve kurulum notları model skill içinde paketlenir; uygulama doğru kontrattan başlar.
Sık sorulan sorular
tts-1 ve tts-1-hd arasındaki fark nedir?
tts-1 etkileşimli oynatmada düşük gecikmeye; tts-1-hd ise anlatım ve tamamlanmış içerikte daha yüksek ses kalitesine öncelik verir.
OpenAI TTS hangi ses formatını döndürür?
Her iki varyant da RunAPI yanıtında format, MIME türü ve bayt boyutu meta verileriyle MP3 ses döndürür.
Oluşturulan ses RunAPI tarafından barındırılıyor mu?
Evet. RunAPI, sesi doğrular ve geçici kaynak URL'sini açığa çıkarmak yerine yönetilen bir URL döndürür.
Özel bir ses veya hız seçebilir miyim?
İlk endpoint, yayımlanmış varsayılan ses ve hızı kullanır. Özel ses ve hız kontrolleri bu endpoint sözleşmesinin parçası değildir.
Metinden sese üretim senkron mu?
Evet. Başarılı bir istek, ayrı bir sorgulama endpoint'i gerekmeden tamamlanmış ses sonucunu doğrudan döndürür.
Hangi varyantla başlamalıyım?
Kalite beklentinizi karşılayan en uygun fiyatlı varyantı seçin. Çoğu ekip hızlı varyantla başlar ve üretimde pro sürüme geçer.
Ücretsiz bir katman var mı?
Yeni hesaplar her modelde ilk çağrıları ücretsiz alır. Sonrasında çağrı başına ödeme yaparsınız.
Sonuçları streaming olarak sunuyor musunuz?
Streaming desteklendiğinde RunAPI uçtan uca streaming sağlar.
Başarısız işlemler nasıl ücretlendirilir?
Başarısız üretimler ücretlendirilmez.
Çıktılar önbelleğe alınıyor mu?
Üretilen çıktılar saklanır ve görev ID’siyle geri alınabilir. Girdiler önbelleğe alınmaz.
Ticari kullanım yapabilir miyim?
Evet — bir model lisansı bunu açıkça kısıtlamadıkça ticari kullanım tüm varyantlarda dahildir; kısıtlamalar varyant sayfasında belirtilir.
Oran limitleri ne durumda?
Anahtar bazlı oran limitleri kullanım kademesine göre ölçeklenir. Güncel limitler için fiyatlandırma sayfasına bakın.
Sorunları nereye bildirebilirim?
Herkese açık GitHub reposunda bir issue açın veya destek ekibine e-posta gönderin.