Authentication

Configure API authentication for the Fish Audio Python SDK

Get Your API Key

Create a Fish Audio account

Sign up for a free Fish Audio account to get started with our API.

1. Go to fish.audio/auth/signup
2. Fill in your details to create an account, complete steps to verify your account.
3. Log in to your account and navigate to the API section

Get your API key

Once you have an account, you’ll need an API key to authenticate your requests.

1. Log in to your Fish Audio Dashboard
2. Navigate to the API Keys section
3. Click “Create New Key” and give it a descriptive name, set a expiration if desired
4. 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:

Environment Variable (Recommended)

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.

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