Agent skill · creative production · aiskillstore
fish-audio
Generate AI text-to-speech audio with Fish Audio and browse public reference voices via AceDataCloud API. Use when creating voiceover/narration audio (TTS), synthesizing multilingual speech, or selecting a Fish reference voice from the model catalog.
Why this skill is useful
Provides specific API commands and workflows for generating text-to-speech audio that the AI wouldn't reliably generate on its own.
What it needs
Requires acedatacloud account access. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Fish Audio — Text-to-Speech Generate narration / voiceover through AceDataCloud's Fish Audio API. Setup: See authentication for token setup. Quick Start Synchronous responses return a direct audio URL: Endpoints Endpoint Purpose ---------- --------- POST /fish/tts Text-to-speech generation GET /fish/model Browse/search public Fish reference voices POST /fish/tasks Poll async TTS jobs when async: true Workflows 1. Find a reference voice The response includes items[] with public voice metadata such as id, title, languages, tags, visibility, and state. Use an item id as referenceid in TTS requests. 2. Text-to-Speech 3. Async TTS Async: See async task polling. Poll via POST /fish/tasks with {"id":"..."}. Parameters — /fish/tts Header Parameter Values Description ----------- -------- ------------- model "s1", "s2-pro" Fish TTS engine selection JSON body Parameter Type / Values Description ----------- --------------- ------------- text string Text to synthesize (required) referenceid string Public/reference voice ID from GET /fish/model format "mp3", "wav", "pcm", "opus" Output format samplerate integer Optional output sample rate mp3bitrate 64, 128, 192 MP3 bitrate opusbitrate integer Opus bitrate latency "normal", "balanced" TTS latency mode chunklength / minchunklength integer Chunking controls temperature, topp, repetitionpenalty number Sampling controls maxnewtokens integer Maximum generated tokens normalize boolean Normalize generated audio prosody object Prosody tuning references array Additional reference objects callbackurl string Async callback URL async boolean Run asynchronously and poll /fish/tasks Gotchas The documented TTS endpoint is POST /fish/tts — not /fish/audios. Choose the Fish engine with the model request header, not a JSON model field. Use referenceid from GET /fish/model — not voiceid. Synchronous requests return audiourl directly; async jobs should be polled via /fish/tasks. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/fish-audio