fish-audio

Fish Audio — Voice & Audio Synthesis

Generate AI audio and synthesize voices through AceDataCloud's Fish Audio API.

Setup: See authentication for token setup.

Quick Start

curl -X POST https://api.acedata.cloud/fish/audios \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello, this is a demonstration of AI voice synthesis."}'

Async: See async task polling. Poll via POST /fish/tasks with {"id": "..."}.

Endpoints

Endpoint	Purpose
POST /fish/audios	Generate audio from text or parameters
POST /fish/voices	Voice synthesis and cloning
POST /fish/tasks	Poll task status

Workflows

1. Text-to-Speech

POST /fish/audios
{
  "prompt": "The quick brown fox jumps over the lazy dog.",
  "voice_id": "default"
}

2. Voice Cloning — Register a Voice

Upload a reference audio to create a cloneable voice.

POST /fish/voices
{
  "voice_url": "https://example.com/reference-voice.mp3",
  "title": "My Custom Voice",
  "description": "Clear, neutral-toned speaker for TTS",
  "image_url": "https://example.com/avatar.jpg"
}

3. Text-to-Speech with Cloned Voice

POST /fish/audios
{
  "prompt": "Welcome to our platform.",
  "voice_id": "<voice_id from POST /fish/voices>"
}

Parameters

/fish/audios

Parameter	Type	Description
prompt	string	Text to synthesize into speech
voice_id	string	Voice model or cloned voice ID to use
model	string	TTS model (e.g., "speech-1.5", "speech-1.5-hd")
action	string	Operation type (e.g., "generate")
callback_url	string	Webhook URL for async delivery

/fish/voices

Parameter	Type	Description
voice_url	string	Reference audio URL for voice cloning
title	string	Display title for the cloned voice
description	string	Description of the voice
image_url	string	Cover image URL for the voice
callback_url	string	Webhook URL for async delivery

Gotchas

• Pricing is based on byte count of the generated audio
• Voice cloning requires a clear reference audio sample
• Text-to-speech supports multiple languages automatically
• Use the /fish/voices endpoint to register a reference audio and receive a voice_id for TTS