Fish Audio API
Dostęp do API Fish Audio do ekspresyjnej, wielojęzycznej syntezy mowy klasy produkcyjnej, z plikiem MP3 zarządzanym przez RunAPI.
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": "Zamień tę krótką narrację dokumentalną na ekspresyjną, naturalną mowę o równym tempie."
}'
import { FishAudioClient } from "@runapi.ai/fish-audio";
const client = new FishAudioClient();
const result = await client.textToSpeech.run({
model: "s1",
text: "Zamień tę krótką narrację dokumentalną na ekspresyjną, naturalną mowę o równym tempie.",
});
require "runapi/fish_audio"
client = RunApi::FishAudio::Client.new
result = client.text_to_speech.run(
model: "s1",
text: "Zamień tę krótką narrację dokumentalną na ekspresyjną, naturalną mowę o równym tempie."
)
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 cursor
Fish Audio zamienia tekst na mowę przez synchroniczny endpoint RunAPI. Wybierz s1 do ekspresyjnych nagrań albo s2.1-pro jako zalecany model produkcyjny z 83 językami i naturalnym sterowaniem ekspresją. s2-pro pozostaje dostępną opcją poprzedniej generacji.
- Wiele wariantów dla różnych poziomów szybkości i jakości
- Model skill zawiera dokumentację, schematy i notatki setupu
- Działa z workflow kodowania aplikacji
- Nie płacisz za nieudane generacje
Porównaj wszystkie warianty API
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Zainstaluj skill Fish Audio do tworzenia aplikacji
Wczytaj dokumentację modelu, schematy, notatki cenowe i kroki setupu do workspace kodu.
# Install the model skill for app development workflows
npx skills add runapi-ai/fish-audio -g
Install 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.
Od model skilla do pierwszego wyniku w czterech krokach
Wybierz model
Wybierz model i wariant pasujące do typu wyjścia, progu jakości i celu opóźnienia.
Konfiguracja
Ustaw klucz RunAPI i zainstaluj model skill w workspace kodu.
Implementacja
Użyj instrukcji skilla, aby dodać funkcję modelu w swojej aplikacji.
Odbiór
Odpytuj po task ID, streamuj gdy wspierane albo obsłuż callback webhook.
Czym jest API Fish Audio?
Fish Audio oferuje modele syntezy mowy do ekspresyjnych dialogów i niezawodnych procesów produkcji nagrań głosowych. RunAPI weryfikuje każdy wynik i zwraca zarządzany adres URL pliku MP3 wraz z metadanymi audio.
Dlaczego używać API Fish Audio przez RunAPI
Jedno uwierzytelnienie, wszyscy providerzy
Jeden klucz RunAPI odblokowuje cały katalog. Bez osobnych kont i rotacji kluczy dla każdej integracji.
Ujednolicony cennik i rozliczenia
Rozliczanie za wywołanie w USD, fakturowane co miesiąc. Nieudane generacje nie są naliczane.
Skill ze schematami
Typowane schematy i notatki setupu są spakowane w model skill, więc implementacja startuje od właściwego kontraktu.
Najczęstsze pytania
Czym różnią się s1, s2-pro i s2.1-pro?
s1 służy do ekspresyjnej mowy. s2.1-pro jest zalecany do produkcji, obsługuje 83 języki i sterowanie ekspresją; s2-pro pozostaje opcją poprzedniej generacji.
Jaki format audio zwraca Fish Audio?
Domyślnym formatem jest MP3, a opcjonalnie można wybrać WAV. Odpowiedź RunAPI zawiera prawidłowy format, typ MIME i rozmiar w bajtach.
Czy mogę pokierować głosem za pomocą próbki referencyjnej?
Tak. Utwórz głos należący do konta i używaj jego RunAPI voice_id w kolejnych żądaniach zamiany tekstu na mowę. Aby wpłynąć tylko na bieżące żądanie, przekaż przez references dźwięk base64 z dokładnym transkryptem.
Czy RunAPI przechowuje wygenerowany plik audio?
Tak. RunAPI weryfikuje i zapisuje wynik, zanim zwróci zarządzany adres URL pliku audio.
Czy muszę odpytywać endpoint o zakończenie?
Nie. Endpoint działa synchronicznie i zwraca gotowy wynik audio w odpowiedzi na pomyślne żądanie.
Od jakiego wariantu powinienem zacząć?
Wybierz najtańszy wariant, który spełnia Twoje wymagania jakościowe. Większość zespołów zaczyna od szybkiego wariantu, a do produkcji przechodzi na pro.
Czy jest darmowy plan?
Nowe konta otrzymują darmowe pierwsze wywołania dla każdego modelu. Później płacisz za każde wywołanie.
Czy streamujecie wyniki?
Tam, gdzie streaming jest dostępny, RunAPI streamuje end-to-end.
Jak są rozliczane nieudane próby?
Nieudane generacje nie są obciążane opłatą.
Czy wyniki są buforowane?
Wygenerowane wyniki są zapisywane i można je pobrać po ID zadania. Dane wejściowe nie są buforowane.
Czy mogę używać komercyjnie?
Tak — użycie komercyjne jest dostępne dla każdego wariantu, chyba że licencja modelu wyraźnie to ogranicza; informacja taka jest podana na stronie wariantu.
A co z limitami zapytań?
Limity na klucz rosną wraz z poziomem wykorzystania. Aktualne limity znajdziesz na stronie cennika.
Gdzie mogę zgłosić problem?
Otwórz zgłoszenie w publicznym repozytorium GitHub albo napisz do supportu.