Authentication

Get Your API Key

Create a Fish Audio account

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

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

Keep your API key secret! Never commit it to version control or share it publicly.

Client Initialization

Initialize the FishAudio client with your API key: Install the Python SDK first: pip install fish-audio-sdk.

Environment Variable (Recommended)
Direct API Key
Custom Base URL

The most secure approach is using environment variables:

from fishaudio import FishAudio

# Automatically reads from FISH_API_KEY environment variable
client = FishAudio()

Set the environment variable in your shell:

export FISH_API_KEY=your_api_key_here

Or create a .env file in your project root:

FISH_API_KEY=your_api_key_here

Then load it using python-dotenv:

from dotenv import load_dotenv
from fishaudio import FishAudio

# Load environment variables from .env file
load_dotenv()

client = FishAudio()

Using environment variables keeps your API key out of your codebase and makes it easy to use different keys for development and production.

Provide the API key directly when initializing the client:

from fishaudio import FishAudio

client = FishAudio(api_key="your_api_key_here")

This approach is less secure. Never commit code containing your actual API key. Use this only for quick testing or when loading the key from a secure secrets manager.

If you’re using a proxy or custom endpoint:

from fishaudio import FishAudio

client = FishAudio(
    api_key="your_api_key",
    base_url="https://your-proxy-domain.com"
)

This is useful for:

Corporate proxies
Development/staging environments
Self-hosted deployments

Verifying Authentication

Test your authentication by making a simple API call to check your account credits:

from fishaudio import FishAudio
from fishaudio.exceptions import AuthenticationError

try:
    client = FishAudio()

    # Check account credits (requires valid authentication)
    credits = client.account.get_credits()
    print(f"Authentication successful! Credits: {credits.credit}")

except AuthenticationError:
    print("Authentication failed. Check your API key.")

Handle AuthenticationError when verifying authentication. The example uses get_credits() to verify the authentication works.

Next Steps

Text-to-Speech

Generate speech with the authenticated client

Voice Cloning

Clone voices and create custom models

Account Management

Check credits and manage your account

Error Handling

Handle authentication errors properly

Set Up the SDK

Cookbook

Best Practices

Integrations

Compatible APIs

Self-Hosting

More

Get Your API Key

Client Initialization

Verifying Authentication

Next Steps

Text-to-Speech

Voice Cloning

Account Management

Error Handling