ANanam
Voices

create voice

Changed on

Create a voice by cloning from audio or importing an existing provider voice. Send clone audio inline as multipart/form-data (the whole request must stay under ~4.5MB), or first upload a larger clip via POST /v1/voices/presigned-upload and reference its audioKey. Provider imports are checked against Anam's supported model registry. Cartesia, ElevenLabs, and Fish Audio imports must successfully generate a sample before the voice is persisted; the first import of an ElevenLabs Voice Library voice typically takes about a minute while ElevenLabs adds it to Anam's account. New integrations should prefer POST /v1/voice-imports for synchronous validation and preview generation.

post/v1/voices

Request

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

Request body

OR

Response

Successfully cloned or imported a 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