Voice Clone API Documentation

Overview

Convert text to natural-sounding speech using a library of built-in voices, or clone a custom voice from a short audio sample for consistent narration.

Primary Endpoint

POST/api/v1/userVoice/training

Start voice training

Request Parameters

Name	Type	Required	Description
name	string	Yes	Name of the voice model
voice_urls	array<string>	Yes	Array of audio file URLs for training
gender	enum: female \| male	No	Voice gender
denoise	boolean	No	Whether to apply denoising
enhance_voice_similarity	boolean	No	Whether to enhance voice similarity
model	enum: a2e \| cartesia \| minimax \| elevenlabs	No	Voice model to use
language	string	No	Language code from client (e.g. en-US, zh-CN). If omitted, server will infer from request headers.
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/userVoice/training" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Custom Voice",
  "voice_urls": [
    "https://example.com/audio1.wav",
    "https://example.com/audio2.wav"
  ],
  "gender": "female",
  "denoise": true,
  "enhance_voice_similarity": true,
  "model": "a2e",
  "language": "en-US",
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/anchor/tts_list

List system voices (TTS presets)

POST/api/v1/anchor/language_list

List supported languages/regions for voices

POST/api/v1/anchor/voice_list

List available voices by country/region

GET/api/v1/anchor/voice_list

List available voices (GET)

POST/api/v1/video/send_tts

Generate text-to-speech audio

GET/api/v1/tts/preview/list

Get TTS preview list

DELETE/api/v1/tts/preview/{id}

Delete TTS preview record

POST/api/v1/userVoice/training

Start voice training

GET/api/v1/userVoice/trainingRecord

Get voice training records

GET/api/v1/userVoice/completedRecord

Get completed voice training records

DELETE/api/v1/userVoice/{_id}

Delete voice training record

GET/api/v1/userVoice/{_id}

Get voice training record detail

PUT/api/v1/userVoice/{_id}

Update voice training record name

Responses

200

Voice training record created successfully

400

Bad Request - Invalid training data

401

Unauthorized - Invalid or missing bearer token

403

Forbidden - Voice clone limit exceeded