Fish Audio MCP
Synthesize speech, manage sound, and query audio tasks in the AI Agent through MCP.
High-performance text-to-speech (TTS) based on Fish Audio. A piece of text can synthesize natural human voice, supporting s1 / s2-pro dual models, voice cloning, and can retrieve over 1.8 million public voice samples. The request body is consistent with the official one, just replace it with the platform Token.
From text-to-speech to voice cloning, a single interface covers the complete voice synthesis process.
Submit the text to be synthesized with text, s2-pro has stronger emotion and expressiveness, s1 is more stable and less likely to deviate with long texts, switched via the request header model.
Pass reference_id to reuse existing voices, or use references to inline reference samples for instant replication—making the synthesized voice close to the specified speaker.
Retrieve public voices through GET /fish/model, filter by language, tag, title, and once you have the _id, you can use it as reference_id.
Short text sync directly returns audio_url; for long texts, pass callback_url to immediately get task_id, and receive results via callback upon completion—can also actively pull using the Tasks interface.
Just need text and format to synthesize, synchronously return a playable or downloadable audio_url. The field names are consistent with Fish official, zero cost for migration.
curl -X POST https://api.acedata.cloud/fish/tts \
-H "authorization: Bearer YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"text": "The weather is really nice today, let's go for a walk together.",
"format": "mp3"
}'
# Synchronously return a playable audio direct link (tested):
# {
# "audio_url": "https://platform.r2.fish.audio/task/05f81919f2e04e35bb404a88fb177854.mp3"
# }
From obtaining the Token to getting the audio, it only takes a few minutes.
Apply for an API Token in the console, one Token can call all services on the platform, first time free quota is given.
Call POST /fish/tts, pass in text and format (mp3 or pcm).
Synchronously return audio_url, play directly or save; long text uses callback_url for callback.
From audio content to in-app voice, covering most speech synthesis needs.
Convert articles and manuscripts into natural human voice in bulk, using s1 to stably process long text content.
Generate narration for short videos, tutorials, and explanations, adjusting speed and volume with prosody.
Dynamically generate prompts and scripts, maintaining brand voice consistency with fixed tones.
Provide reading capabilities for web pages and documents, outputting pcm for real-time client-side playback.
Customize exclusive voice lines for characters using voice cloning, quickly filling a large number of lines.
Real-time synthesize scripts into speech, driving digital voices and virtual anchor live streaming scenarios.
Text-to-speech and voice management, with field naming completely consistent with Fish official.
Submit text to synthesize human voice, supporting format (mp3/pcm), prosody speed and volume, mp3_bitrate bitrate, and sample_rate sampling rate.
Clone new voice tones using reference audio, retrieve from a library of over 1.8 million public voice tones, or query individual voice details by _id—the obtained _id can be directly used as reference_id.
Pay as you go, no subscription fees, no hidden costs.
Voice retrieval (GET /fish/model) free
TTS charges based on the length of synthesized text, voice cloning is charged per use
Exclusive plans for high-usage teams
Common questions about using the Fish Audio API
TTS is billed based on the UTF-8 byte length of the synthesized text, approximately $0.011 / thousand characters (i.e., $10.5 / million bytes, which is 30% off Fish's official $15); the three models s1, s2-pro, and s2.1-pro are priced the same. Voice cloning (POST /fish/model) is billed per use, approximately $0.48 / use; voice retrieval (GET /fish/model) is free. A free quota is given upon first registration for direct experience.
The format in the request body must be explicitly set, options are mp3 or pcm. mp3 can use mp3_bitrate (64/128/192) to control the bitrate; pcm is suitable for real-time stitching in browsers or client-side post-processing (mixing, speed changes).
Two methods: pass reference_id to reuse an existing voice (which can be retrieved from the public library using GET /fish/model to get the _id, or clone your own voice using POST /fish/model); or use references to inline reference samples for instant replication. Choose one of the two.
Switch via the request header model, default is s2-pro. s2-pro has stronger expressiveness and emotion, suitable for short sentences and voiceovers; s1 is more stable, less prone to deviation with long texts, suitable for audiobooks and other long content.
Synthesizing long texts may take several seconds to tens of seconds. Pass callback_url in the request body, the interface will immediately return {task_id, started_at}, and after completion, it will POST the result back to that URL; you can also use the Fish Tasks interface to actively pull by task_id.
audio_url is a direct link from Fish R2, and the signature is usually valid for 1 hour. It is recommended to download and store it in your own object storage as soon as you receive it. The link extension is fixed as .mp3, and the actual content is the byte stream specified by format in the request.
Ace Data Cloud offers a variety of AI audio and music generation APIs
Get natural human voice from a piece of text in seconds. Supports voice cloning and 1.8 million+ voice library.