ANanam
Voices

update voice

Changed on

Update a voice by ID (display name and provider model ID can be updated)

put/v1/voices/{id}

Request

  • Base URL
    https://api.anam.ai
  • URL
    https://api.anam.ai/v1/voices/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Voice ID

Request body

displayNamestring required

New display name for the voice

providerModelId'sonic-3.6' | 'sonic-3.6-2026-08-27' | 'sonic-3.5' | 'sonic-3.5-2026-05-04' | 'sonic-3' | 'sonic-3-2026-01-12' | 'sonic-2' | 'sonic-latest' | 'eleven_v4_turbo' | 'eleven_v3_conversational' | 'eleven_v4' | 'eleven_v3' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 's2.1-pro' | 's2-pro' | 's1'

An Anam-supported model ID for the voice's existing provider. The voice/model pair is validated with the provider before it is saved.

gender'MALE' | 'FEMALE' | 'NEUTRAL' | 'null' nullable

Voice gender

countrystring nullable

ISO 3166-1 alpha-2 country code

descriptionstring nullable

Voice description

Example request

{
  "providerModelId": "sonic-3.5"
}

Response

Successfully updated voice

idstring uuid

Unique identifier for the voice.

displayNamestring

Human-readable name shown in the Lab.

provider'CARTESIA' | 'ELEVENLABS' | 'FISH_AUDIO'

Upstream TTS provider for this voice.

providerVoiceIdstring nullable

The upstream provider's identifier for the voice.

providerModelIdstring nullable

The upstream provider's model identifier used to generate speech.

sampleUrlstring uri nullable

URL of a short audio preview of the voice.

previewSampleUrlstring uri nullable

Alias for sampleUrl, kept for backwards compatibility.

gender'MALE' | 'FEMALE' | 'NEUTRAL' | 'null' nullable

Perceived gender of the voice, if categorised.

countrystring nullable

ISO 3166-1 alpha-2 country code representing the voice's accent.

descriptionstring nullable

Free-form description of the voice's character.

displayTagsstring[]

Tags used to categorise the voice in the Lab UI.

isZdrboolean

Whether this voice meets the Zero Data Retention requirements.

createdByOrganizationIdstring nullable

ID of the organization that created the voice, or null for stock voices. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.

createdAtstring date-time

Timestamp when the voice was created.

updatedAtstring date-time

Timestamp when the voice was last updated.

Changes

  • e85ef0cd491eRevision changes
    • info

      added the non-success response with the status

  • bb35a5087dd6Revision changes
    • info

      added the new eleven_v4 enum value to the request property

    • info

      added the new eleven_v4_turbo enum value to the request property