Authentification

L’API VoiceCheap utilise des clés API pour l’authentification. Toutes les requêtes API doivent inclure votre clé API dans l’en-tête x-api-key.

Obtenir votre clé API

Connectez-vous à VoiceCheap

Allez sur app.voicecheap.ai et connectez-vous à votre compte.

Accédez à la page API

Allez sur la page API à l’adresse app.voicecheap.ai/page-api.

Générer une clé API

Cliquez sur Créer une nouvelle clé et donnez un nom à votre clé. Votre clé API complète ne sera affichée qu’une seule fois - copiez-la et stockez-la immédiatement en lieu sûr.

Important : Enregistrez votre clé immédiatementVotre clé API complète n’est affichée qu’une seule fois lors de sa création. Après avoir fermé la fenêtre modale, vous ne verrez qu’une version masquée (vc_abc...xyz). Si vous perdez votre clé, vous devrez la supprimer et en créer une nouvelle.

Limites des clés API

Vous pouvez créer un maximum de 5 clés API par compte
Chaque clé peut être nommée pour une identification facile (par exemple, “Production”, “Développement”)
Les clés peuvent être supprimées à tout moment depuis la page API

Utilisation de votre clé API

Incluez votre clé API dans l’en-tête x-api-key avec chaque requête :

curl -X POST https://api.voicecheap.ai/v1/translate \
  -H "x-api-key: vc_your-api-key-here" \
  -F "file=@video.mp4" \
  -F "targetLanguage=spanish"

const formData = new FormData();
formData.append('file', videoFile);
formData.append('targetLanguage', 'spanish');

const response = await fetch('https://api.voicecheap.ai/v1/translate', {
  method: 'POST',
  headers: {
    'x-api-key': 'vc_your-api-key-here'
  },
  body: formData
});

const data = await response.json();

const formData = new FormData();
formData.append('file', videoFile);
formData.append('targetLanguage', 'spanish');

const response = await fetch('https://api.voicecheap.ai/v1/translate', {
  method: 'POST',
  headers: {
    'x-api-key': 'vc_your-api-key-here'
  },
  body: formData
});

const data = await response.json();

import requests

files = {'file': open('video.mp4', 'rb')}
data = {'targetLanguage': 'spanish'}
headers = {'x-api-key': 'vc_your-api-key-here'}

response = requests.post(
    'https://api.voicecheap.ai/v1/translate',
    headers=headers,
    files=files,
    data=data
)

Prérequis

Abonnement payant requisL’accès à l’API nécessite un abonnement payant actif. Les comptes gratuits ne peuvent pas utiliser l’API. Si vous tentez d’utiliser l’API sans abonnement valide, vous recevrez une erreur 403 Forbidden.

Sécurité des clés API

Gardez-la secrète

Ne divulguez jamais votre clé API dans le code côté client, dans des dépôts publics ou dans tout emplacement accessible au public.

Utilisez des variables d'environnement

Stockez votre clé API dans des variables d’environnement ou dans un gestionnaire de secrets sécurisé.

Renouvelez régulièrement

Renouvelez périodiquement vos clés API, surtout si vous soupçonnez qu’elles ont pu être compromises.

Surveillez l'utilisation

Suivez l’utilisation de votre API pour détecter tout accès non autorisé.

Réponses d’erreur

Si l’authentification échoue, vous recevrez l’une des erreurs suivantes :

Code d’état	Code d’erreur	Description
401	`MISSING_API_KEY`	L’en-tête `x-api-key` n’a pas été fourni
401	`INVALID_API_KEY_FORMAT`	La clé API n’utilise pas le préfixe `vc_` attendu
401	`INVALID_API_KEY`	La clé API fournie est invalide
403	`API_ACCESS_REQUIRED`	L’accès à l’API n’est pas activé pour ce compte
403	`SUBSCRIPTION_REQUIRED`	L’accès à l’API nécessite un abonnement payant actif
403	`INSUFFICIENT_CREDITS`	Votre compte ne dispose pas de suffisamment de crédits pour cette opération

Exemple de réponse d’erreur

{
  "code": "INVALID_API_KEY",
  "message": "The provided API key is invalid. Please check your API key and try again."
}

Vue d’ensemble

Transcription

Traduction

Référence

Authentification

Authentification

Obtenir votre clé API

Limites des clés API

Utilisation de votre clé API

Prérequis

Sécurité des clés API

Gardez-la secrète

Utilisez des variables d'environnement

Renouvelez régulièrement

Surveillez l'utilisation

Réponses d’erreur

Exemple de réponse d’erreur

​Authentification

​Obtenir votre clé API

​Limites des clés API

​Utilisation de votre clé API

​Prérequis

​Sécurité des clés API

Gardez-la secrète

Utilisez des variables d'environnement

Renouvelez régulièrement

Surveillez l'utilisation

​Réponses d’erreur

​Exemple de réponse d’erreur

Authentification

Obtenir votre clé API

Limites des clés API

Utilisation de votre clé API

Prérequis

Sécurité des clés API

Réponses d’erreur

Exemple de réponse d’erreur