ElevenLabs Permissions
Vantage cannot perform cost-incurring actions and only ever reads cost and usage data from ElevenLabs. The API key you provide requires Workspace Analytics access, which lets Vantage import your usage and cost data. Optionally, you can grant Voices (read) access so Vantage can enrich the voice IDs returned by the API with human-readable voice names. Vantage cannot create voices, initiate generation requests, or perform any action that incurs costs in your ElevenLabs account. Vantage stores only billing metadata (e.g., credit counts, model usage, and costs). No voice audio or text content is ingested or stored.Due to ElevenLabs API restrictions, Vantage can query a limited number of dimensions at a time from the Usage Analytics API. If ElevenLabs lifts this limitation for your account, Vantage will add further granularity to the available data. Contact your ElevenLabs account team to raise this request.
Connect Your ElevenLabs Account
Prerequisites
- You must have a Vantage Organization Owner or Integration Owner role to add or remove this integration. See the Role-Based Access Control documentation for details.
- You must have access to create API keys in ElevenLabs, with Workspace Analytics access. It’s best practice to use a dedicated key for Vantage and rotate it per your organization’s security policy.
- Create a free Vantage account, then follow the steps below to integrate ElevenLabs costs.
Create the Connection
Navigate to the ElevenLabs API keys page and click + Create Key.
On the Create API Key slideout, scroll down to the Administration section, and select Access next to Workspace Analytics. This permission is required for the integration to work.
If you enable the Restrict Keys toggle to limit which IPs can use this key, add each of the following Vantage IPs to the allowed list so Vantage can reach the ElevenLabs API. Add each IP address individually:
Optionally, under the Endpoints section, grant Voices read access. This is not required, but it allows Vantage to enrich the voice IDs returned in API responses with voice names.
For Description, enter any descriptor to identify this integration, such as your name or workspace. This value is used as the Organization dimension in Cost Report filters.
For Credit rate, choose how Vantage should calculate reported costs:
- Use ElevenLabs’ public rate: Vantage uses the API-reported costs directly, which track ElevenLabs’ rates automatically. This is the default.
- Use my own negotiated rate: enter your Price per 1,000 credits (USD) to calculate costs from credit usage. Select this if you have custom or enterprise pricing.
As soon as costs are processed, they will be available on your All Resources Cost Report. If you decide to remove your ElevenLabs integration from Vantage, all costs associated with your ElevenLabs API key will be removed from the Vantage console.
Next Steps - Manage Workspace Access
Once the import is complete and the integration status changes to Stable, you can select which workspaces this integration is associated with. See the Workspaces documentation for information.Data Refresh
See the provider data refresh documentation for information on when data for each provider refreshes in Vantage. ElevenLabs data refreshes once daily.ElevenLabs Reporting Dimensions
On ElevenLabs Cost Reports, you can filter and group across several dimensions:- Organization (the description you enter when connecting the integration; use Billing Account for filtering and grouping)
- Service (i.e., the model name, such as Eleven Turbo v2 or Eleven Multilingual v2)
- Category (i.e., the product type, such as Text to Speech, Speech to Text, or Conversational AI)
- Resource (i.e., the voice name when Voices (read) access is granted, otherwise the voice ID)
- Charge Type (Usage)
| Tag | Description |
|---|---|
elevenlabs:model | The model identifier associated with the usage (e.g., eleven_turbo_v2) |
elevenlabs:product_type | The ElevenLabs product type (e.g., tts, stt) |
elevenlabs:voice_id | The voice ID associated with the usage |
elevenlabs:voice_name | The voice name, populated when Voices (read) access is granted |
elevenlabs:voice_category | The voice category, populated when Voices (read) access is granted |