The Python SDK is the recommended starting point and is fully covered below.
The JavaScript SDK is in early release. See the JavaScript SDK
guide for its current
surface.
1. Install
2. Authenticate
Create a Fish Audio account
Create a Fish Audio account
Sign up for a free Fish Audio account to get started with our API.
- Sign up on fish.audio
- Fill in your details to create an account, complete steps to verify your account.
- Log in to your account and open Get Started
Get your API key
Get your API key
Once you have an account, you’ll need an API key to authenticate your requests.
- Log in and open Get Started
- Click “Get your API key”: the key is created in one click and shown only once
- Copy your key and store it securely
FISH_API_KEY environment variable:
3. Generate your first audio
output.mp3 (Python) or local playback (JavaScript).
Next steps
Text-to-Speech
Voices, formats, prosody, and model selection
Voice Cloning
Instant cloning and persistent voice models
Realtime WebSocket
Stream LLM tokens to speech as they arrive
Errors & Retries
Exception types, retries, and timeouts
Cookbook
Task-focused recipes
API Reference
Full Python SDK reference

