Skip to main content
Voice import lets you reference a voice by its identifier rather than selecting it from the DialNexa catalog. Use this when you have a specific ElevenLabs voice you already use in another system, when you are configuring agents via API and need stable, predictable voice references, or when a voice exists in a provider catalog but has not yet been added to the DialNexa browsing interface.

​
Voice ID formats

DialNexa supports two types of voice IDs for import. Nexa voice ID (vel_...) Every voice in the DialNexa system has a stable internal identifier prefixed with vel_. This ID does not change even if the provider updates the voice’s display name. Nexa voice IDs are the recommended format for API-configured agents and any integration where you need reproducible references. Example: vel_21m00Tcm4TlvDq8ikWAM Provider voice ID The raw identifier assigned by the voice provider (ElevenLabs, Cartesia, SmallestAI, or Sarvam AI). Provider IDs are alphanumeric strings specific to that provider’s catalog. They are useful when you already know a voice ID from direct ElevenLabs usage and want to bring it into DialNexa without searching the catalog. Example (ElevenLabs): 21m00Tcm4TlvDq8ikWAM

​
When to use voice import

  • You discovered a voice directly on the ElevenLabs platform and know its ID
  • You are configuring agents via the DialNexa API and need a stable voice reference that survives catalog refreshes
  • You want to use a voice from a supported provider (ElevenLabs, Cartesia, SmallestAI, Sarvam AI) that is not in the standard DialNexa catalog
  • You are building a multi-agent system where all agents share the same voice and you want to enforce this via code rather than manual UI selection

​
How to find voice IDs

ElevenLabs voice ID: log in to elevenlabs.io, open the Voice Library, and click on a voice. The voice ID appears in the URL and in the voice detail panel. Nexa voice ID: select any voice in the DialNexa voice selector, then open the voice detail card. The Nexa voice ID (vel_...) is displayed and can be copied. You can also retrieve it via the DialNexa API: 
GET /v1/voices
The response includes voice_id (the Nexa ID) for every voice available in your workspace.

​
Import steps

1

Open Voice Import

In your workspace, go to Settings > Voices > Import Voice.
2

Select the provider

Choose ElevenLabs or the relevant provider from the dropdown. This tells DialNexa how to resolve the ID.
3

Enter the voice ID

Paste the provider voice ID or Nexa voice ID into the input field.
4

Set a display name

Enter a name for this voice in your workspace. The name is for your reference only and does not affect synthesis.
5

Import

Click Import Voice. DialNexa validates the ID against the provider and adds the voice to your workspace. If validation fails, verify the ID is correct and that the voice is publicly available on the provider platform (private or deleted voices cannot be imported).

​
Using an imported voice in the API

Once imported, the voice is available in the voice selector and via the API. Reference it using its Nexa voice ID: 
{
  "voice": {
    "provider": "elevenlabs",
    "voice_id": "vel_xxxxxxxxxxxxxxxx"
  }
}
You can also reference a provider voice ID directly in the API without importing first. DialNexa will resolve it at call time. However, using Nexa voice IDs is preferred because they are immutable and do not depend on provider-side availability at resolution time.

​
Limitations

  • Import is currently supported for ElevenLabs voices. Cartesia voice import is limited to voices in the DialNexa-managed Cartesia catalog.
  • Voices that are private, deleted, or restricted on the provider platform cannot be imported.
  • Imported voices behave identically to catalog voices for the purposes of cloning, language compatibility, and settings.
  • Provider voice IDs can become invalid if the voice owner deletes or unpublishes the voice on the provider platform. Use Nexa voice IDs to avoid this dependency.