Skip to main content
POST
Consultez les métadonnées et un exemple audio à écouter pour une voix de doublage du catalogue ou une voix personnalisée qui vous appartient.

Authentification et autorisations

string
requis
Envoyez une clé API VoiceCheap dans cet en-tête. Authorization: Bearer avec la même clé API est également accepté. Les jetons d’accès OAuth sont acceptés uniquement par MCP, pas par cet endpoint REST.
Autorisations requises: voices:read. Un abonnement payant actif est requis. Les autorisations ne modifient ni les rôles dans l’équipe, ni la propriété des ressources, ni les crédits média, ni les limites du forfait.

Paramètres

string
requis
Valeur textuelle.Longueur minimale: 1. Longueur maximale: 255. Motif: ^[A-Za-z0-9_-]+$.
string
Valeur textuelle.Valeurs acceptées: “en”, “fr”, “es”, “de”, “it”, “pt”, “pl”, “zh”, “ja”. Valeur par défaut: “en”.
Le JSON Schema ci-dessous conserve les noms de champs exacts, les types imbriqués, les valeurs par défaut, les limites et les valeurs acceptées exposés par la découverte. Les règles supplémentaires entre champs figurent dans les notes de l’opération.

Exemples de requêtes

Remplacez les exemples d’identifiants de ressources et de clés média par des valeurs renvoyées pour votre compte. Conservez le même identifiant de requête lorsque vous réessayez la même mutation.

Réponse

Une première exécution réussie renvoie HTTP 200 avec le résultat de l’opération sous data. Une nouvelle tentative peut renvoyer à la place l’état de la requête enregistrée. L’exemple présente une réponse possible, sans tous les champs facultatifs. Une voix de doublage du catalogue ou personnalisée appartenant au compte, avec ses métadonnées publiques et un exemple audio facultatif.

Champs du résultat

Notes de l’opération

  • Utilisez voiceId provenant de dubbing_voices_list. Il s’agit d’un identifiant opaque de 1–255 caractères contenant uniquement des lettres, des chiffres, des tirets bas et des traits d’union.
  • locale utilise les mêmes valeurs par défaut et valeurs acceptées que dubbing_voices_list. Les voix du catalogue peuvent inclure les métadonnées localisées language, accent, description, age, gender, useCase et category.
  • Les voix personnalisées appartenant à l’utilisateur renvoient source: custom et éventuellement previewUrl ; elles omettent les champs de langue du catalogue. Le champ audioExampleUrl d’une réponse brute de clonage est représenté ici par previewUrl.
  • 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

Chaque invocation réussie consomme un appel du quota mensuel API/MCP. Les crédits média et les quotas de génération propres à l’opération s’appliquent également.

Erreurs