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

# Connectors and API keys

> Connect ElevenLabs, OpenRouter, Vbee, Epidemic Sound and Freesound with your own keys.

Connectors link CoClip to online services with your own account. They live in **Settings** → **Connectors**. Every connector is optional: CoClip edits and exports without them.

Each connector has a card. Its header shows **Connected**, **Not set up** or **Re-enter key**.

Screenshot coming soon

Settings → Connectors
State: ElevenLabs card expanded, key saved
Highlight: API key field and Test connection button

## What each connector unlocks

| Connector | What it adds | What you need | Where to get it |
| - | - | - | - |
| **ElevenLabs** | **Generate voice** (text to speech), a second transcription engine, generated music and sound effects | API key | elevenlabs.io → Developers → API keys |
| **OpenRouter** | **Generate** images and short videos from a prompt | API key | openrouter.ai → Keys |
| **Vbee** | Vietnamese voices for text to speech | Token and App ID | vbee.vn → API: create an app, then copy its token and App ID |
| **Epidemic Sound** | Search and insert sound effects from your subscription | Personal API key | [epidemicsound.com/account/api-keys](https://www.epidemicsound.com/account/api-keys) |
| **Freesound** | Search and insert free sound effects (CC0 and CC BY only) | Client ID, client secret and a sign-in | [freesound.org/apiv2/apply](https://freesound.org/apiv2/apply/) |

Each service bills you directly. What you generate or download counts against your account with that service.

## Add a key

**1. Open the connector**

Open **Settings** → **Connectors** and expand the card of the service.

**2. Paste the key**

Paste your key in the **API key** field (Vbee: **Token** and **App ID**) and click **Save**.

**3. Test it**

Click **Test connection**. A ✓ means the service accepted the key.

The card now shows **Connected** and `Configured ✓ ••••` with the last 4 characters of your key. To replace the key, paste a new one and click **Save**. To remove it, click **Remove**.

## ElevenLabs options

* **Test connection** checks **Text to speech** and **Speech to text**, then shows how many characters you've used and when the count resets.
* **Defaults**: the voice (search and play a sample), **Model**, **Language** (English or Vietnamese), **Format** and **Trim silence around generated speech**. Eleven v4 is the default model; Flash v2.5 costs half the credits. **WAV lossless** needs a paid ElevenLabs plan.
* Sliders for **Stability**, **Similarity**, **Style** and **Speed**.
* **Music under the voice**: how far generated music without a set volume sits under the voice while it speaks (6–30 LU, default 16).
* **Ask before spending**: **Ask before jobs over** a number of credits, and **Ask before transcribing over** a number of minutes. These apply to agents and the script panel.

## OpenRouter options

* **Test connection** shows `Images and videos work` and the credits you have left.
* **Default image model** and **Default video model** preselect the models in **Generate**. See [Media and AI generation](/docs/library/media-and-generate.md).

## Vbee options

* **Default voice** and **Speed** (0.8× to 1.3×).
* **Trim silence around generated speech**.
* **Use Vbee for text to speech by default**: requests that name no provider use Vbee, including an agent's.

Vbee returns no word timings. CoClip times the words with its own speech recognition on your computer, for captions and trimming.

## Pronunciation dictionaries

ElevenLabs and Vbee cards have **Pronunciation dictionaries**. Use them when a voice reads a word wrong.

1. Click **New dictionary**, give it a name, and add rows of **Word** → **Say as**. For example, Google → Gu-gồ.
2. Click **Create dictionary**. Use **Add rule** later to add more rows.
3. Tick up to 3 dictionaries to use for every generation.

Captions keep the original word. On ElevenLabs, **Advanced (IPA)** adds phoneme rules, which work on eleven\_v4, flash\_v2 and v3 only. Vbee dictionaries are stored on your computer.

## Epidemic Sound and Freesound

**Epidemic Sound**: paste your personal API key and click **Save**. Sounds you insert are downloaded with your key and count against your Epidemic Sound subscription.

**Freesound** needs your own free API credential and a sign-in:

**1. Create a credential**

Create a free API credential on Freesound. Keep the **Callback URL** shown in the card in that credential.

**2. Paste the credential**

Paste the **Client ID** and **Client secret** in the card and save each one.

**3. Sign in**

Click **Sign in with Freesound**. To sign in from your browser instead, open **Sign in in your browser instead**, click **Copy sign-in link**, open the link, then paste the code Freesound shows and click **Sign in**.

Search and previews work before you sign in. Inserting a sound needs the sign-in. CoClip lists only CC0 and CC BY sounds; CC BY sounds need credit to their author where you publish the video. You agree to Freesound's API terms, linked in the card. See [Sound effects](/docs/library/sound-effects.md).

## How CoClip keeps your keys

* Keys are stored encrypted on your computer: with Windows DPAPI, or in the macOS Keychain item "CoClip Safe Storage".
* CoClip shows only the last 4 characters of a saved key.
* Keys are never saved in projects, so sharing a project folder never shares your keys.
* CoClip uses a key only to call its service. It is never sent to SilaFlow.
* Agents never see your keys and never need them. Enter keys only in **Settings** → **Connectors**, never in an agent chat.

Text, audio, prompts and images you send to a service are processed by that service.

If a card shows **Re-enter key**, see [Troubleshooting](/docs/reference/troubleshooting.md).

## Related pages

* [Settings](/docs/reference/settings.md)
* [Script](/docs/library/script.md)
* [Media and AI generation](/docs/library/media-and-generate.md)
* [Sound effects](/docs/library/sound-effects.md)


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