Fish Audio API
İfade gücü yüksek, çok dilli ve prodüksiyon kalitesinde metinden sese üretim ile yönetilen MP3 çıktısı için Fish Audio API erişimi.
curl -X POST https://runapi.ai/api/v1/fish_audio/text_to_speech \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "s1",
"text": "Bu kısa belgesel anlatımını tutarlı tempoya sahip, ifade gücü yüksek ve doğal bir seslendirmeye dönüştürün."
}'import { FishAudioClient } from "@runapi.ai/fish-audio";
const client = new FishAudioClient();
const result = await client.textToSpeech.run({
model: "s1",
text: "Bu kısa belgesel anlatımını tutarlı tempoya sahip, ifade gücü yüksek ve doğal bir seslendirmeye dönüştürün.",
});require "runapi/fish_audio"
client = RunApi::FishAudio::Client.new
result = client.text_to_speech.run(
model: "s1",
text: "Bu kısa belgesel anlatımını tutarlı tempoya sahip, ifade gücü yüksek ve doğal bir seslendirmeye dönüştürün."
)npx skills add runapi-ai/fish-audio -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 cursorFish Audio, senkron bir RunAPI endpoint'i üzerinden metni sese dönüştürür. İfade gücü yüksek ses için s1'i, 83 dil ve doğal dilde ifade kontrolü sunan önerilen prodüksiyon modeli için s2.1-pro'yu seçin. s2-pro önceki nesil bir seçenek olarak kullanılmaya devam eder.
- 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
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Uygulama geliştirme için Fish Audio 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/fish-audio -gInstall the Fish Audio skill for this app: 1. Add runapi-ai/fish-audio 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.
Fish Audio API nedir?
Fish Audio, ifade gücü yüksek diyaloglar ve güvenilir prodüksiyon ses iş akışları için metinden sese modelleri sunar. RunAPI her sonucu doğrular ve ses meta verileriyle birlikte yönetilen bir MP3 URL'si döndürür.
Fish Audio 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
s1, s2-pro ve s2.1-pro arasındaki fark nedir?
s1 ifade gücü yüksek ses içindir. s2.1-pro, 83 dil ve ifade kontrolüyle prodüksiyon için önerilir; s2-pro önceki nesil seçenek olarak kullanılabilir.
Fish Audio hangi ses formatını döndürür?
Varsayılan format MP3'tür ve WAV seçilebilir. RunAPI yanıtı gerçek formatı, MIME türünü ve bayt boyutunu içerir.
Sesi bir referans örneğiyle yönlendirebilir miyim?
Döndürülen bir RunAPI voice_id değerini sonraki metinden sese isteklerinde kullanmayı deneyebilirsiniz, ancak kullanılabilirliği garanti edilmez. Yalnızca mevcut isteği yönlendirmek için references üzerinden base64 ses ve tam transkript gönderin.
Oluşturulan ses RunAPI tarafından barındırılıyor mu?
Evet. RunAPI, yönetilen ses URL'sini döndürmeden önce sonucu doğrular ve saklar.
Tamamlanmasını sorgulamam gerekir mi?
Hayır. Endpoint senkrondur ve başarılı yanıtta tamamlanmış ses sonucunu 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.