fish-audiolisted
Install: claude install-skill AceDataCloud/Skills
# Fish Audio — Voice & Audio Synthesis
Generate AI audio and synthesize voices through AceDataCloud's Fish Audio API.
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
## Quick Start
```bash
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](../_shared/async-tasks.md). 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
```json
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.
```json
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
```json
POST /fish/audios
{
"prompt": "Welcome to our platform.",
"voice_id": "<voice_id from POST /fish/voices>"
}
```
## Parameters
### `/fish/audios`
| Parameter | Type | Descr