List Voice Models

Retrieve the TTS model variants available for a given voice, each with its own latency, naturalness, and cost profile.

GET /voices/{id}/voice-models

List voice models for a voice

cURL

curl --request GET \
  --url https://api.dialnexa.com/v1/voices/{id}/voice-models \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "vmod_abc",
      "name": "Multilingual v2",
      "description": "High quality, multilingual TTS model.",
      "latency": "low"
    }
  ]
}

Returns the text-to-speech model variants available for a given voice. Each entry corresponds to a deployable model (for example eleven_multilingual_v2, eleven_turbo_v2) and includes the upstream provider. Different variants of the same voice trade off latency, naturalness, and cost. Use this endpoint to populate the model selector in your agent build UI and to confirm a saved model_id is still supported before publishing an agent change.

When to use this

• Voice configuration UIs: let the prompt author choose between latency-optimized and quality-optimized variants of the same voice.
• Latency tuning: switch a real-time agent to a “turbo” model when first-word latency matters more than expressiveness.
• Cost optimization: switch a high-volume outreach use case to a cheaper variant if naturalness is acceptable.
• Migration safety checks: confirm the saved model_id is still in the response before deploying an agent update.

Common trade-offs

Across providers, voice models tend to cluster into three loose tiers:

• Turbo / low latency: fastest first-word time. Best for live conversational agents where caller perception of speed matters most.
• Multilingual / balanced: moderate latency with broad language support. The default for most production deployments.
• High fidelity / premium: best naturalness and prosody. Typically reserved for branded greetings or scripted spoken content rather than free-flowing live conversation.

Path parameters

Parameter	Description
id	The voice ID, for example vce_en_us_ava.

Errors

• 404 Not Found is returned when the voice does not exist or has been removed.

Request

curl "https://api.dialnexa.com/v1/voices/vce_en_us_ava/voice-models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    { "id": "eleven_multilingual_v2", "name": "Eleven Multilingual v2", "provider": "elevenlabs" },
    { "id": "eleven_turbo_v2",        "name": "Eleven Turbo v2",        "provider": "elevenlabs" }
  ]
}

Related endpoints

• Get Voice: fetch the voice itself.
• List Voices: browse the full voice catalogue.
• Update Agent: change the voice or model assigned to an agent.
• Text-to-speech and voices: guidance on choosing the right voice model.

Authorizations

Authorization · string · header · required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id · string · required

Voice ID.

Response

200 - application/json

Success.

data · object[]

Show child attributes