Sign in
Voices

Validate and import a provider voice

Synchronously validates the provider voice/model and persists the Voice only after a real TTS preview succeeds. A provider validation may take up to 90 seconds, after a best-effort metadata lookup of up to 5 seconds; the first import of an ElevenLabs Voice Library voice typically takes about a minute while ElevenLabs adds it to Anam's account. Only provider and providerVoiceId are required. Omitted displayName and description use provider metadata; supplied values take precedence. If unavailable, the name is Imported <providerVoiceId> and the description is null. This endpoint does not accept voice-clone audio; use POST /v1/voices for cloning. No Idempotency-Key is required. Every successful request creates a new Voice, even when the same provider voice ID and model already exist in the organization. Omitted models resolve to the provider default. Repeating a request does not reuse an existing Voice.

post/v1/voice-imports

Request body

displayNamestring

Optional name override. Defaults to the provider name (trimmed and limited to 191 characters), or Imported <providerVoiceId> if unavailable.

provider'CARTESIA' | 'ELEVENLABS' | 'FISH_AUDIO' required
providerVoiceIdstring required

Voice identifier from the selected provider.

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_flash_v2_5' | 'eleven_flash_v2' | 'eleven_multilingual_v2' | 'eleven_turbo_v2_5' | 'eleven_v3' | 'eleven_v3_conversational' | 'eleven_v4' | 'eleven_v4_turbo' | 's2.1-pro' | 's2-pro' | 's1'

Supported model for the selected provider. Omit for the provider default.

providerConfigobject
sampleUrlstring uri
gender'MALE' | 'FEMALE' | 'NEUTRAL'
countrystring
descriptionstring

Optional description override. Defaults to provider metadata, or null if unavailable. An explicit empty string is preserved.

Response

The validated Voice was created.

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

Changed in 5 of the 23 revisions of this API.17

  • bb35a5087dd62See the full diff
    • ○

      added the new eleven_v4 enum value to the request property

      request-property-enum-value-added

    • ○

      added the new eleven_v4_turbo enum value to the request property

      request-property-enum-value-added

  • dc7e31f03c6611See the full diff
    • ▲

      removed the enum value OPENAI_ADVANCED_VOICE of the request property

      request-property-enum-value-removed

    • ○

      removed the OPENAI_ADVANCED_VOICE enum value from the response property for the response status

      response-property-enum-value-removed

  • f4d1a1caad421See the full diff
    • ○

      added the new sonic-3.6-2026-08-27 enum value to the request property

      request-property-enum-value-added

  • 450b7bc2c11f2See the full diff
    • ○

      added the new eleven_v3 enum value to the request property

      request-property-enum-value-added

    • ○

      added the new eleven_v3_conversational enum value to the request property

      request-property-enum-value-added

  • c89509d879181See the full diff
    • ○

      endpoint added

      endpoint-added