Skip to main content
The Finesse API authenticates with a workspace API key. Send it on every request in the X-API-Key header:
Keys are prefixed flv_. The server only stores a hash, so the full key is shown once - when you create it.

​
Create a key

1

Open the dashboard

Sign in to the Finesse dashboard and go to Settings → API keys.
2

Create a key

Create a new key and name it. The secret (flv_…) is displayed once - copy it now.
3

Store it safely

Keep it in a secret manager or an environment variable (FLAM_API_KEY). If you lose it, revoke it and create a new one.
Treat the key like a password - it can synthesize with every voice in your workspace. Never put it in client-side code or commit it to source control. If a key leaks, revoke it from the dashboard.

​
What a key can access

A key is bound to one workspace and can:
  • List and read the voices in that workspace.
  • Synthesize speech with any ready voice in it (speak, stream, WebSocket).
It can’t create or delete voices - that happens in the dashboard. Referencing a voice from another workspace returns 404.

​
Authentication errors

See Errors & responses for the full list.