fish-audio

Original：🇺🇸 English
Translated

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.

12installs
Sourceacedatacloud/skills
Added on

NPX Install

npx skill4agent add acedatacloud/skills fish-audio

Tags

Translated version includes tags in frontmatter
text-to-speechfish-audioacedatacloud-apiai-ttsvoice-synthesis

SKILL.md Content

View Translation Comparison →

Fish Audio — Text-to-Speech

Generate narration / voiceover through AceDataCloud's Fish Audio API.
Setup: See authentication for token setup.

Quick Start

bash
curl -X POST https://api.acedata.cloud/fish/tts \
  -H "Authorization: ******ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "model: s2-pro" \
  -d '{"text":"你好，欢迎使用 AceData Cloud。","reference_id":"d7900c21663f485ab63ebdb7e5905036","format":"mp3"}'
Synchronous responses return a direct audio URL:
json
{"audio_url":"https://platform.r2.fish.audio/task/8a72ff9840234006a9f74cb2fa04f978.mp3"}

Endpoints

EndpointPurpose
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

bash
curl "https://api.acedata.cloud/fish/model?page_size=10&page_number=1&title=Marcus" \
  -H "Authorization: ******ACEDATACLOUD_API_TOKEN"
The response includes 
items[]
with public voice metadata such as 
_id
, 
title
, 
languages
, 
tags
, 
visibility
, and 
state
. Use an item 
_id
as 
reference_id
in TTS requests.

2. Text-to-Speech

json
POST /fish/tts
Headers:
  model: s2-pro

{
  "text": "Your narration text.",
  "reference_id": "d7900c21663f485ab63ebdb7e5905036",
  "format": "mp3"
}

3. Async TTS

json
POST /fish/tts
Headers:
  model: s1

{
  "text": "Longer narration for background processing.",
  "async": true,
  "callback_url": "https://api.acedata.cloud/health"
}
Async: See async task polling. Poll via 
POST /fish/tasks
with 
{"id":"..."}
.

Parameters — 
/fish/tts

Header

ParameterValuesDescription
model
"s1"
, 
"s2-pro"
Fish TTS engine selection

JSON body

ParameterType / ValuesDescription
text
stringText to synthesize (required)
reference_id
stringPublic/reference voice ID from 
GET /fish/model
format
"mp3"
, 
"wav"
, 
"pcm"
, 
"opus"
Output format
sample_rate
integerOptional output sample rate
mp3_bitrate
64
, 
128
, 
192
MP3 bitrate
opus_bitrate
integerOpus bitrate
latency
"normal"
, 
"balanced"
TTS latency mode
chunk_length
/ 
min_chunk_length
integerChunking controls
temperature
, 
top_p
, 
repetition_penalty
numberSampling controls
max_new_tokens
integerMaximum generated tokens
normalize
booleanNormalize generated audio
prosody
objectProsody tuning
references
arrayAdditional reference objects
callback_url
stringAsync callback URL
async
booleanRun 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 
    reference_id
    from 
    GET /fish/model
    — not 
    voice_id
    .
  • Synchronous requests return 
    audio_url
    directly; async jobs should be polled via 
    /fish/tasks
    .
  • The current OpenAPI spec documents voice browsing via 
    GET /fish/model
    ; it does not document a voice-cloning write endpoint.