ElevenLabs Provider

The ElevenLabs provider reads subscription usage from the ElevenLabs API using an API key.

Features

• Character credit usage from the current subscription period.
• Reset timing when the API returns next_character_count_reset_unix.
• Voice slot and professional voice slot usage when those fields are present.
• Plan/status text from the subscription response.

Setup

CLI

Store the API key without opening Settings:

printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

This trims the piped key, writes it to ~/.codexbar/config.json with restrictive permissions, and enables ElevenLabs by default. Use --no-enable to save the key without enabling the provider.

Settings

1. Open Settings -> Providers
2. Enable ElevenLabs
3. Open https://elevenlabs.io/app/settings/api-keys
4. Create or copy an API key
5. Paste the key into CodexBar's ElevenLabs provider settings

Environment Variables

CodexBar also accepts these environment variables:

• ELEVENLABS_API_KEY
• XI_API_KEY

For tests or self-hosted/proxy setups, override the API base URL with ELEVENLABS_API_URL.

How It Works

• Endpoint: GET https://api.elevenlabs.io/v1/user/subscription
• Auth header: xi-api-key
• Fields used: character_count, character_limit, voice_slots_used, voice_limit, professional_voice_slots_used, professional_voice_limit, tier, status, next_character_count_reset_unix

Troubleshooting

"Missing ElevenLabs API key"

Set the key with codexbar config set-api-key --provider elevenlabs --stdin, add it in Settings -> Providers -> ElevenLabs, set ELEVENLABS_API_KEY, or configure an ElevenLabs token account.

"ElevenLabs rejected the selected API key"

ElevenLabs returned an authentication or access error identifying invalid_api_key. Confirm that the key is valid and has not been revoked. If you configured multiple ElevenLabs API-key accounts, the active account takes precedence over the standalone API key field.

"ElevenLabs API key is missing the user_read permission"

ElevenLabs returned HTTP 401 or 403 identifying missing_permissions or insufficient_permissions. Enable the user_read permission for the selected key so CodexBar can fetch subscription usage.

"ElevenLabs could not authenticate the selected API key"

ElevenLabs returned HTTP 401 without a recognized error status. Check the key and its endpoint permissions.

"ElevenLabs denied access for the selected API key"

ElevenLabs returned HTTP 403 without a recognized key or permission error. Check the key's endpoint permissions and IP allowlist in the ElevenLabs API-key settings.

CodexBar reads recognized detail.code values first, as described in ElevenLabs' error documentation. It also reads the legacy detail.status when the current code is absent or generic; live responses can still use that field for the specific rejection reason. Provider error messages are not copied into these diagnostics.

"ElevenLabs API error"

Confirm that the current network can reach api.elevenlabs.io and check the reported HTTP status.