curl --location 'https://api.inworld.ai/voices/v1/voices:clone' \
--header "Authorization: Basic $INWORLD_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "displayName": "my_voice_clone_demo",
  "languageCode": "en-US",
  "voiceSamples": [
    {
      "audioData": "<base64-audio-data>",
      "transcription": "Hello! This is a short voice sample for cloning."
    }
  ],
  "description": "Voice clone created from provided WAV sample.",
  "tags": ["demo", "clone"],
  "audioProcessingConfig": {
    "removeBackgroundNoise": true
  }
}'

import requests

url = "https://api.inworld.ai/voices/v1/voices:clone"
headers = {
    "Authorization": "Basic <api-key>",
    "Content-Type": "application/json"
}
payload = {
    "displayName": "my_voice_clone_demo",
    "languageCode": "en-US",
    "voiceSamples": [
        {
            "audioData": "<base64-audio-data>",
            "transcription": "Hello! This is a short voice sample for cloning."
        }
    ],
    "description": "Voice clone created from provided WAV sample.",
    "tags": ["demo", "clone"],
    "audioProcessingConfig": {
        "removeBackgroundNoise": True
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const url = 'https://api.inworld.ai/voices/v1/voices:clone';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'Basic <api-key>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    displayName: 'my_voice_clone_demo',
    langCode: 'EN_US',
    voiceSamples: [
      {
        audioData: '<base64-audio-data>',
        transcription: 'Hello! This is a short voice sample for cloning.',
      },
    ],
    description: 'Voice clone created from provided WAV sample.',
    tags: ['demo', 'clone'],
    audioProcessingConfig: {
      removeBackgroundNoise: true,
    },
  }),
});

const data = await response.json();
console.log(data);

{
  "audioSamplesValidated": [
    {
      "audioData": "<base64-wav-bytes>",
      "errors": [],
      "langCode": "EN_US",
      "transcription": "Hello! This is a short voice sample for cloning.",
      "warnings": []
    }
  ],
  "voice": {
    "voiceId": "your_workspace_id__my_voice_clone_demo_20260218_223134z",
    "langCode": "EN_US",
    "displayName": "my_voice_clone_demo",
    "description": "Voice clone created from provided WAV sample.",
    "tags": [
      "demo",
      "clone"
    ],
    "name": "workspaces/your_workspace_id/voices/my_voice_clone_demo_20260218_223134z",
    "source": "IVC"
  }
}

{
  "code": 7,
  "message": "API key has insufficient access level for 'voices' in workspace 'your_workspace_id'. Current access level in API key: read (r). Required access level: write (rw).",
  "details": []
}