> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyager.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose your generation providers

> Connect media accounts and keys, choose their order, and control automatic fallback.

A generation provider is the account Voyager uses to make an image, video, voice, music track, or sound effect.

For example, you can use ChatGPT for the conversation and your FAL key for the video. The agent subscription and the generation provider are separate connections, with separate bills.

## Set the provider order

Open **Settings → Accounts → Generation providers**. Voyager starts with the first connected, enabled provider in your list that offers the requested model.

On a fresh setup, the order is:

| Provider | Connection | What it offers |
| - | - | - |
| Higgsfield | Sign in to your Higgsfield account | Images and video on your Higgsfield plan |
| FAL | Your FAL API key | A broad catalog of generation models |
| Google | Your Google API key | Gemini images and Veo video |
| ElevenLabs | Your ElevenLabs API key | Voices, music, and sound effects |
| Voyager credits | Your Voyager account and a Voyager plan | Generation paid with your workspace's Voyager credits |

An existing installation may have a different order. Use the list shown in your app as the guide to which account Voyager will try first. A provider cannot run every model just because it appears in the list.

<Frame caption="The arrows change which provider Voyager tries first. Automatic fallback controls whether it can move on after a failure.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-order.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=1d4c8457f5d98a2e078d76fb9febc135" alt="The Generation providers list, numbered 1 to 5: Higgsfield (Inactive, Sign in), FAL (Key ending in 4d3e, Remove), Google and ElevenLabs (Inactive, Add key) and Voyager credits (Billed to Demo Studio). Each row has an on/off switch and up and down arrows. Below the list, the Automatic fallback switch is on." width="2048" height="898" data-path="images/screenshots/providers-order.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-order.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=e64a94661fad032bf28dd156a14b5ed2" alt="The Generation providers list, numbered 1 to 5: Higgsfield (Inactive, Sign in), FAL (Key ending in 4d3e, Remove), Google and ElevenLabs (Inactive, Add key) and Voyager credits (Billed to Demo Studio). Each row has an on/off switch and up and down arrows. Below the list, the Automatic fallback switch is on." width="2048" height="898" data-path="images/screenshots/providers-order.dark.png" />
</Frame>

1. Connect the providers you want to use.
2. Move your preferred provider up with its arrow.
3. Turn off the switch beside any provider you do not want used for new generations.
4. Review **Automatic fallback** below the list.

Changes apply to new jobs. They do not move a job that is already running to another account.

## Add your own media keys

Your own keys work without a paid Voyager plan. The provider bills your account directly.

1. Find **FAL**, **Google**, or **ElevenLabs** in **Generation providers**.
2. Choose **Add key**. Use the key-page link in that row if you need to create one.
3. Paste the key into **Paste your key** and choose **Save**.
4. Check the row's connection status before starting a generation.

<Frame caption="Save the key in the provider's row, then check its connection status.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-add-key.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=c80ccdc7fff23495034147d5ab6aec39" alt="The FAL row expanded to show a FAL API key field with a pasted key, Paste, Save and Cancel buttons, and a Get a key at fal.ai/dashboard/keys hint." width="1980" height="324" data-path="images/screenshots/providers-add-key.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-add-key.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=4f1c558bd932d35ed3a1743f52c5ffcd" alt="The FAL row expanded to show a FAL API key field with a pasted key, Paste, Save and Cancel buttons, and a Get a key at fal.ai/dashboard/keys hint." width="1980" height="324" data-path="images/screenshots/providers-add-key.dark.png" />
</Frame>

Keys entered here are saved in your system's secure storage, not in project files. Paste keys into the account controls, not into a chat.

If Voyager detects a key you already configured on your computer, check that it is the account you intend to pay with. A saved key takes precedence over a key from your environment.

## Understand automatic fallback

**Automatic fallback** is on by default. If a generation provider is out of credits, rejects its sign-in, or is down, Voyager tries the next usable provider in your list. It shows a notification that names the provider and where the generation continued, for example **Higgsfield is out of credits** with **Continued on Voyager credits** below it. Settings such as duration or resolution may change slightly to match what that provider offers; the notification lists the main changes.

<Frame caption="A fallback notification: the title names the provider that failed, the line below names where the generation continued.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-fallback-toast.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=9c0fe8adffdefea6e10150d58d116f82" alt="A warning notification titled Higgsfield is out of credits, with the line Continued on Voyager credits and an Open Settings button." width="864" height="336" data-path="images/screenshots/providers-fallback-toast.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/providers-fallback-toast.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=a1695d9272f350e88014035bd04031da" alt="A warning notification titled Higgsfield is out of credits, with the line Continued on Voyager credits and an Open Settings button." width="864" height="336" data-path="images/screenshots/providers-fallback-toast.dark.png" />
</Frame>

<Warning>
  Fallback can bill a different account. For example, a job that starts with your Higgsfield plan can continue using a personal API balance or Voyager credits.
</Warning>

Turn **Automatic fallback** off if you want Voyager to stop when the first usable provider fails. For one request, ask the agent to pin a provider: “Generate this with my FAL account only. Pin FAL and stop if it cannot run.” A pinned provider prevents fallback for that request.

Fallback does not fix rejected inputs or a content-filter refusal. A model that needs a higher Voyager plan also needs you to choose an included model or change the plan; Voyager does not automatically charge another account to get around that refusal.

## Higgsfield plan versus API balance

These are two separate balances:

* **Higgsfield** in **Generation providers** signs in to your Higgsfield plan. Choose **Sign in** and finish in your browser. If Voyager detects an existing sign-in, it may offer **Use this account**.
* **Higgsfield API balance**, inside **Voyager → Use your own API keys**, uses a separate prepaid API balance. Enter the key in the **key ID:secret** format shown in the field and choose **Save key**.

When both are connected, Voyager tries the plan before the API balance. With automatic fallback enabled, a depleted plan can continue on the API balance. The notification says **Higgsfield plan credits ran out** and tells you where the generation continued.

Turning fallback off prevents that move for a failed plan attempt. If no plan sign-in is connected, the saved API key can still be the Higgsfield connection used first. Remove the API key if you do not want Voyager to use that balance at all.

## Check who paid

Read any fallback notification and inspect the generation in the chat's **Jobs** panel. An out-of-credits message for FAL or Higgsfield refers to that provider account, not necessarily your Voyager balance.

Managed Voyager voices always use your Voyager account; rearranging this list does not move them to a personal key.

For credit renewals and auto-reload, see [Plans and credits](/account/plans-and-credits). For expired sign-ins, refused keys, or stopped jobs, see [Generation problems](/help/generation-problems).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.