Use the Fish Audio API via RunAPI with a model skill, unified auth, and pay-as-you-go pricing.
curl -X POST https://runapi.ai/api/v1/fish_audio/text_to_speech \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "s1",
"text": "Turn this short documentary narration into expressive, natural speech with consistent pacing."
}'import { FishAudioClient } from "@runapi.ai/fish-audio";
const client = new FishAudioClient();
const result = await client.textToSpeech.run({
model: "s1",
text: "Turn this short documentary narration into expressive, natural speech with consistent pacing.",
});require "runapi/fish_audio"
client = RunApi::FishAudio::Client.new
result = client.text_to_speech.run(
model: "s1",
text: "Turn this short documentary narration into expressive, natural speech with consistent pacing."
)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 converts text into speech through a synchronous RunAPI endpoint. Choose s1 for expressive conversational or narrative audio, s2.1-pro as the recommended production model with 83 languages and natural-language expression control, or s2-pro for previous-generation workflows.
| Endpoint | Resolution | Duration | Price | |
|---|---|---|---|---|
| text_to_speech | — | — | $0.02 / 1K UTF-8 bytes |
Prices shown for s1. Other variants retain their own endpoint pricing.
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Sign up and generate an API key from the dashboard.
Choose the version that best matches your quality and cost requirements.
Submit your prompt and parameters to the model's documented endpoint.
Poll the task or set a webhook, then download the completed output.
Fish Audio provides text-to-speech models for expressive dialogue and dependable production voice workflows. RunAPI validates each result and returns a managed MP3 or WAV URL with audio metadata.
A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.
Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.
Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.
s1 targets expressive conversational and narrative speech. s2.1-pro is recommended for production TTS with 83 languages and natural-language expression control; s2-pro remains available for previous-generation workflows.
Requests return MP3 by default and can select WAV. The RunAPI response includes accurate format, MIME type, and byte-size metadata.
You can try a returned RunAPI voice_id in later text-to-speech requests, but availability is not guaranteed. For one request only, pass reference samples with base64 audio and exact transcripts through references.
Yes. RunAPI validates and stores the result before returning a managed audio URL.
No. The endpoint is synchronous and returns the completed audio result in the successful response.
Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.