> For the complete documentation index, see [llms.txt](https://blackridge.gitbook.io/sonicforge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://blackridge.gitbook.io/sonicforge/api-keys-and-provider-setup.md).

# API Keys and Provider Setup

SonicForge sends generation requests to the external AI audio provider you select. You must supply your own API key.

{% hint style="info" %}

### API Keys

## <mark style="color:$success;">Get your API Keys</mark>

### <mark style="color:blue;">ElevenLabs</mark>

> 1. Open Eleven Labs -> [ElevenLabs](https://elevenlabs.io/app/home)
> 2. In the left bar go down till you find Developers
> 3. Click in the top on API Keys
> 4. Click on Create your Key
> 5. You need to click on Access on the option Sound Effects
> 6. Create the Key and save the key somewhere safe

### <mark style="color:pink;">fal.ai</mark>

> 1. Open fal.ai over this link -> [fal.ai](https://fal.ai)
> 2. Click on Add Key and select your desired options.
> 3. Create it and save the key somewhere safe

{% endhint %}

## <mark style="color:blue;">Configure a provider</mark>

1. Open the SonicForge window in Unreal Editor.
2. Open Settings.
3. Select the provider you want to use: ElevenLabs or fal.ai.
4. Enter the API key associated with that provider.

The available models and their capabilities may change as providers update their services. Consult the provider's official documentation for account setup, access permissions, model availability, and current pricing.

## <mark style="color:$warning;">Keep your key secure</mark>

* Treat your API key as a secret. Do not share it in screenshots, public repositories, support posts, or project files intended for public distribution.
* Use only keys you are authorized to use.
* If you believe a key has been exposed, revoke or rotate it through the provider.
* SonicForge does not automatically assign a key or provide bundled API access.

## <mark style="color:green;">Costs and limits</mark>

API access and generation may incur additional charges from ElevenLabs or fal.ai. Provider side rate limits, account permissions, or billing status can affect generation.

## <mark style="color:violet;">Troubleshooting key issues</mark>

* Check that the correct provider is selected for the key you entered.
* Verify that the key is complete and has not expired or been revoked.
* Confirm your provider account has access to the selected model.
* Check the provider's dashboard for usage limits, billing issues, or service incidents.
* Retry with a supported model after correcting the provider-side issue.

If the issue persists, contact [Blackridge support on Discord](https://discord.gg/JyFES68sHt). Do not post your API key.