Fish Audio — Voice & Audio Synthesis
Generate AI audio and synthesize voices through AceDataCloud's Fish Audio API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
Quick Start
curl -X POST https://api.acedata.cloud/fish/audios \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"text": "Hello, this is a demonstration of AI voice synthesis."}'
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
{
"text": "The quick brown fox jumps over the lazy dog.",
"voice_id": "default"
}
2. Voice Synthesis with Custom Voice
POST /fish/voices
{
"text": "Welcome to our platform.",
"audio_url": "https://example.com/reference-voice.mp3"
}
Parameters
| Parameter | Type | Description |
|---|
text | string | Text to synthesize into speech |
voice_id | string | Voice model to use |
audio_url | string | Reference audio for voice cloning |
speed | number | Speech speed multiplier |
Task Polling
POST /fish/tasks
{"task_id": "your-task-id"}
Response
{
"task_id": "abc123",
"audio_url": "https://cdn.example.com/output.mp3",
"success": true
}
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 for voice cloning workflows
