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

# ElevenLabs

> Learn how to integrate Vantage with ElevenLabs to track voice AI cost and usage.

Vantage integrates with your ElevenLabs account using a read-only API key to ingest cost and usage data through the ElevenLabs [Usage Analytics API](https://elevenlabs.io/docs/api-reference/workspace/usage/get-usage-by-product-over-time). Vantage retrieves detailed cost and usage data broken down by model (e.g., Eleven Turbo v2, Eleven Multilingual v2), product type (e.g., Text to Speech, Speech to Text, Conversational AI), and voice. [Usage data](/usage_based_reporting) is available for ElevenLabs, measured in credits.

## 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.

<Note>
  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.
</Note>

## 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](/rbac) 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](https://console.vantage.sh/signup), then follow the steps below to integrate ElevenLabs costs.

### Create the Connection

<Steps>
  <Step>
    Navigate to the [ElevenLabs API keys](https://elevenlabs.io/app/developers/api-keys) page and click **+ Create Key**.
  </Step>

  <Step>
    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.

    <Info>
      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:

      ```
      54.87.66.45
      3.95.43.133
      54.162.3.72
      44.199.143.63
      3.218.103.23
      ```
    </Info>
  </Step>

  <Step>
    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.
  </Step>

  <Step>
    Click **Create Key** and copy your newly generated key.
  </Step>

  <Step>
    From the top navigation in Vantage, click **Settings**.
  </Step>

  <Step>
    On the left navigation, select **Integrations** > **ElevenLabs**.
  </Step>

  <Step>
    The ElevenLabs integration page is displayed. Ensure you are on the **Connect** tab.
  </Step>

  <Step>
    Click **Add API Key** and paste your previously generated API key.
  </Step>

  <Step>
    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.
  </Step>

  <Step>
    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.
  </Step>

  <Step>
    Click **Connect Account**.
  </Step>
</Steps>

After clicking **Connect Account**, you will see the status of your integration change to **Importing** within the Vantage console. This status indicates that Vantage is actively importing your ElevenLabs cost data. Vantage backfills up to six months of historical cost data upon initial connection. See the [Integration Status](/vantage_account#integration-status) documentation for details on integration statuses. You can connect multiple ElevenLabs accounts, each with its own API key, as separate integrations in Vantage.

<Info>
  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.
</Info>

### 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](/workspaces#manage-workspace-provider-integrations) documentation for information.

## Data Refresh

See the [provider data refresh documentation](/provider_data_refresh) for information on when data for each provider refreshes in Vantage. ElevenLabs data refreshes once daily.

## ElevenLabs Reporting Dimensions

On ElevenLabs [Cost Reports](/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)

In addition, ElevenLabs costs include the following provider tags, which are automatically created by Vantage and available for filtering and grouping alongside any [Virtual Tags](/tagging) you create:

| 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   |