curl --request POST \
--url https://api.anam.ai/v1/voice-imports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayName": "Customer support voice",
"provider": "CARTESIA",
"providerVoiceId": "voice_abc123",
"providerModelId": "sonic-3.6",
"country": "GB"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"displayName": "<string>",
"provider": "CARTESIA",
"providerVoiceId": "<string>",
"providerModelId": "<string>",
"sampleUrl": "<string>",
"previewSampleUrl": "<string>",
"gender": "MALE",
"country": "<string>",
"description": "<string>",
"displayTags": [
"<string>"
],
"isZdr": true,
"createdByOrganizationId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}create voice import
curl --request POST \
--url https://api.anam.ai/v1/voice-imports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"displayName": "Customer support voice",
"provider": "CARTESIA",
"providerVoiceId": "voice_abc123",
"providerModelId": "sonic-3.6",
"country": "GB"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"displayName": "<string>",
"provider": "CARTESIA",
"providerVoiceId": "<string>",
"providerModelId": "<string>",
"sampleUrl": "<string>",
"previewSampleUrl": "<string>",
"gender": "MALE",
"country": "<string>",
"description": "<string>",
"displayTags": [
"<string>"
],
"isZdr": true,
"createdByOrganizationId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
- Option 1
- Option 2
Import a provider voice by its ID. To import an ElevenLabs Professional Voice Clone by its share link, send CreateShareLinkVoiceImportRequest instead.
CARTESIA, ELEVENLABS, FISH_AUDIO Voice identifier from the selected provider.
1 - 128^[A-Za-z0-9_-]+$Optional name override. Defaults to the provider name (trimmed and limited to 191 characters), or Imported if unavailable.
1 - 191Supported model for the selected provider. Omit for the provider default.
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 MALE, FEMALE, NEUTRAL 2Optional description override. Defaults to provider metadata, or null if unavailable. An explicit empty string is preserved.
ELEVENLABS only. Validate and speak with your organization's saved ElevenLabs API key (PUT /v1/voices/elevenlabs-key) instead of Anam's, for a voice in your own ElevenLabs account: an instant clone, a Voice Design voice or a Professional Voice Clone. The voice gets isZdr: false, and ElevenLabs bills its speech to the key's account.
Response
A share link for a voice the organization already has on this model; its preview was regenerated and any displayName applied.
A voice preset a persona can use for text-to-speech.
Unique identifier for the voice.
Human-readable name shown in the Lab.
Upstream TTS provider for this voice.
CARTESIA, ELEVENLABS, FISH_AUDIO The upstream provider's identifier for the voice.
The upstream provider's model identifier used to generate speech.
URL of a short audio preview of the voice.
Alias for sampleUrl, kept for backwards compatibility.
Perceived gender of the voice, if categorised.
MALE, FEMALE, NEUTRAL, null ISO 3166-1 alpha-2 country code representing the voice's accent.
Free-form description of the voice's character.
Tags used to categorise the voice in the Lab UI.
Whether this voice meets the Zero Data Retention requirements.
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.
Timestamp when the voice was created.
Timestamp when the voice was last updated.
Was this page helpful?