Lister les voix de doublage

POST https://api.voicecheap.ai/v1/actions/dubbing_voices_list

​

Authentification et autorisations

​

Paramètres

{
  "type": "object",
  "properties": {
    "locale": {
      "default": "en",
      "type": "string",
      "enum": ["en", "fr", "es", "de", "it", "pt", "pl", "zh", "ja"]
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 35
    },
    "search": {
      "type": "string",
      "maxLength": 100
    }
  },
  "additionalProperties": false
}

​

Exemples de requêtes

curl --request POST 'https://api.voicecheap.ai/v1/actions/dubbing_voices_list' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"locale":"en","language":"en","search":"Studio narrator"}'

const input = {
  locale: 'en',
  language: 'en',
  search: 'Studio narrator',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/dubbing_voices_list', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.VOICECHEAP_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);

import os
import requests

response = requests.post(
    "https://api.voicecheap.ai/v1/actions/dubbing_voices_list",
    headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
    json={"locale": "en", "language": "en", "search": "Studio narrator"},
    timeout=120,
)
body = response.json()
if not response.ok:
    raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)

​

Réponse

{
  "data": {
    "voices": [
      {
        "id": "dubbing_voice_R8q3k9Yp",
        "name": "Studio narrator",
        "source": "custom",
        "previewUrl": "https://files.example.com/dubbing-narrator.mp3"
      }
    ],
    "cloneUsage": {
      "limit": 7,
      "used": 1,
      "remaining": 6
    }
  }
}

​

Champs du résultat

​

Notes de l’opération

• Il s’agit de la bibliothèque de doublage vidéo. Utilisez voices_list pour le catalogue TTS distinct et les sélections clone:<UUID>.
• locale vaut en par défaut et accepte en, fr, es, de, it, pt, pl, zh et ja. Si un texte traduit est manquant, le texte anglais ou une autre traduction disponible est utilisé.
• search, facultatif, recherche une sous-chaîne sans tenir compte de la casse dans le nom de la voix et la description localisée, avec un maximum de 100 caractères après suppression des espaces en début et en fin.
• Le champ facultatif language contient 2–35 caractères et doit correspondre exactement aux métadonnées language ou languages du catalogue. Les voix sans métadonnées de langue, y compris les voix personnalisées, restent incluses.
• La liste n’est pas paginée. Les voix du catalogue et les voix personnalisées possèdent des métadonnées facultatives différentes. L’utilisation des emplacements de clonage compte uniquement les voix de doublage personnalisées enregistrées.
• L’exemple filtre une seule voix personnalisée appartenant à l’acteur. Son champ de liste est previewUrl ; le clonage renvoie le même exemple audio sous audioExampleUrl.
• L’historique de synthèse vocale et les voix personnalisées appartiennent au compte authentifié. La facturation d’équipe ne donne pas accès à la synthèse vocale ni aux voix d’un autre membre.

​

Utilisation

​

Erreurs

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "This credential does not permit the requested action.",
  "status": 403,
  "details": {
    "requiredScopes": ["voices:read"]
  }
}