Voices API

List voices

GET/v1/voices

Query parameters

providerstring
genderstring
accentstring
languagestring
searchstring

Case-insensitive substring match on name

Returns

200.

curl "https://api.dialgem.com/v1/voices" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
[
  {
    "id": "string",
    "provider": "string",
    "provider_voice_id": "provider_voice_123",
    "is_custom": false,
    "created_by": "string",
    "name": "Example",
    "gender": "string",
    "accent": "string",
    "age": "string",
    "voice_type": "string",
    "language": [
      "string"
    ],
    "preview_url": "https://example.com"
  }
]

Clone voice

POST/v1/voices/clone

Clone a voice from uploaded audio into this organization's catalog.

Request body multipart/form-data

namestringrequired
filesarray<string>required
consent_confirmedbooleanrequired

Must be true. You are asserting that you hold the rights to this audio and the speaker's consent to clone their voice.

enginestring

Default "elevenlabs"

descriptionstring
languagestring

Default "en"

Returns

201 with the fields below.

idstringrequired

Dialgem's id for the voice. Use it to delete a cloned voice.

providerstringrequired

The speech engine that owns the voice, such as `elevenlabs` or `cartesia`.

provider_voice_idstringrequired

The engine's own id. Put this in an agent's `voice_id`.

is_custombooleanrequired

True for a voice your organization cloned. Platform voices are false.

namestringrequired

Display name.

languagearray<string>required

Language codes the voice can speak.

created_bystring

Who cloned the voice and confirmed consent. Null for platform voices.

genderstring

Voice gender, when the engine reports one.

accentstring

Accent, when the engine reports one.

agestring

Age range, when the engine reports one.

Show 5 more parameters
voice_typestring

Engine category for the voice.

preview_urlstring

A short sample you can play.

raw_metadataany

What the engine returned about the voice, unmodified.

created_atstring

ISO 8601 creation time.

updated_atstring

ISO 8601 time of the last change.

cURL
curl -X POST "https://api.dialgem.com/v1/voices/clone" \
  -H "X-API-Key: $DIALGEM_API_KEY" \
  -F "name=value" \
  -F "files=value" \
  -F "consent_confirmed=value"
Response 201
{
  "id": "string",
  "provider": "string",
  "provider_voice_id": "provider_voice_123",
  "is_custom": false,
  "created_by": "string",
  "name": "Example",
  "gender": "string",
  "accent": "string",
  "age": "string",
  "voice_type": "string",
  "language": [
    "string"
  ],
  "preview_url": "https://example.com"
}

Delete voice

DELETE/v1/voices/{voice_id}

Delete a voice this organization cloned, at the provider and here.

Path parameters

voice_idstringrequired

Returns

200 with the fields below.

deletedbooleanrequired

Always true on success.

voice_idstringrequired

The id that was deleted.

curl -X DELETE "https://api.dialgem.com/v1/voices/VOICE_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "deleted": false,
  "voice_id": "voice_123"
}