curl --location 'https://api.inworld.ai/voices/v1/voices/<voice-id>:localize' \
--header "Authorization: Basic $INWORLD_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "targetLanguage": "de-DE"
}'

import base64
import requests

voice_id = "<voice-id>"
url = f"https://api.inworld.ai/voices/v1/voices/{voice_id}:localize"
headers = {
    "Authorization": "Basic <api-key>",
    "Content-Type": "application/json"
}
payload = {"targetLanguage": "de-DE"}

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

# Save each candidate preview to a WAV file so you can listen
for c in data["candidates"]:
    with open(f"candidate_{c['candidateId']}.wav", "wb") as f:
        f.write(base64.b64decode(c["previewAudio"]))
print(data["draftVoiceId"], [c["candidateId"] for c in data["candidates"]])

const voiceId = '<voice-id>';
const url = `https://api.inworld.ai/voices/v1/voices/${voiceId}:localize`;

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': 'Basic <api-key>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ targetLanguage: 'de-DE' }),
});

const data = await response.json();
console.log(data.draftVoiceId, data.candidates.map((c) => c.candidateId));

{
  "draftVoiceId": "your_workspace_id__localize-70f3d90e",
  "candidates": [
    {
      "candidateId": "293127bb4b69",
      "engine": "engine_b",
      "previewAudio": "<base64-wav-bytes>",
      "transcription": "Hallo Welt"
    },
    {
      "candidateId": "f81e64399e72",
      "engine": "engine_a",
      "previewAudio": "<base64-wav-bytes>",
      "transcription": "Hallo Welt"
    }
  ]
}

{
  "code": 3,
  "message": "This voice has 20 languages and the maximum is 20",
  "details": []
}