Erreurs

L'API VIDIO utilise un format d'objet d'erreur cohérent. Utilisez cette page pour comprendre les types d'erreurs courants, les codes d'état HTTP et les messages d'exemple retournés par l'API.

L'accès à l'API est actuellement disponible uniquement pour les plans Enterprise. Demandez l'accès ici si vous n'êtes pas un utilisateur Enterprise mais êtes intéressé à utiliser l'API.

Aperçu

Lorsqu'une requête échoue, l'API VIDIO retourne un objet erreur avec un type et un message. Certaines erreurs peuvent également inclure des champs supplémentaires pour aider à expliquer l'échec.

Format d'erreur

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Travail non trouvé"
  }
}

Référence d'erreur

Status	Type	Message	Description
400	invalid_request_error	Paramètres de requête requis manquants dans la demande d'URL de téléchargement	Renvoyé lorsque les paramètres de requête requis sont manquants dans la demande d'URL de téléchargement.
400	invalid_request_error	job_id manquant	Renvoyé lorsque la requête de rendu n'inclut pas d'identifiant de travail.
400	invalid_request_error	Aucun output disponible pour ce travail	Renvoyé lorsque le travail n'a aucun output rendable.
400	invalid_request_error	input_keys doit être un tableau non vide	Renvoyé lorsque `input_keys` est manquant ou vide.
400	invalid_request_error	input_keys doit contenir au moins une clé d'entrée valide	Renvoyé lorsque toutes les clés d'entrée fournies sont vides ou invalides après normalisation.
400	invalid_request_error	video_category invalide. Valeurs autorisées : podcast, sports de balle, sports sans balle, démonstration de produit de beauté, mariage, voyage, autres	Renvoyé lorsque `video_category` n'est pas pris en charge.
400	invalid_request_error	aspect_ratio invalide. Valeurs autorisées : carré, portrait, paysage	Renvoyé lorsque `aspect_ratio` n'est pas pris en charge.
400	invalid_request_error	output_length doit être un nombre positif	Renvoyé lorsque `output_length` est manquant, zéro ou négatif.
400	invalid_request_error	Impossible de déterminer la durée d'entrée positive à partir des métadonnées de input_keys	Renvoyé lorsque l'API ne peut pas déterminer une durée valide pour les entrées téléchargées.
401	authentication_error	Clé API manquante	Renvoyé lorsque l'en-tête `x-api-key` n'est pas fourni.
401	authentication_error	Clé API invalide	Renvoyé lorsque la clé API fournie ne correspond pas à une clé active.
402	insufficient_balance	Vous n'avez pas suffisamment de crédits pour traiter ce travail	Renvoyé lorsque le compte n'a pas suffisamment de crédits pour le traitement ou le rendu.
403	permission_error	Vous n'avez pas la permission d'accéder à ce travail	Renvoyé lorsque l'utilisateur authentifié ne possède pas le travail demandé.
403	permission_error	Vous n'avez pas la permission de rendre ce travail	Renvoyé lorsque l'utilisateur authentifié ne possède pas le travail étant rendu.
404	invalid_request_error	Travail non trouvé	Renvoyé lorsque le travail demandé n'existe pas.
404	invalid_request_error	Utilisateur non trouvé	Renvoyé lorsque l'enregistrement de l'utilisateur authentifié ne peut pas être trouvé.
429	rate_limit_error	Trop de requêtes	Renvoyé lorsque le client dépasse le taux de requêtes autorisé pour le point de terminaison. La limite actuelle est de 60 requêtes par minute. La limitation de taux s'applique principalement par clé API à l'aide de l'en-tête x-api-key, et se rabat sur l'adresse IP du client lorsqu'une clé API n'est pas présente. Les clients qui atteignent cette limite doivent réduire la fréquence des requêtes et réessayer après le rétablissement de la fenêtre de limitation de taux.
500	api_error	Erreur d'authentification	Renvoyé lorsque l'authentification de la clé API échoue de manière inattendue sur le serveur.
500	api_error	Erreur interne du serveur	Renvoyé pour des échecs inattendus du côté serveur dans les points de terminaison de statut, de rendu ou de bande-annonce.
500	server_error	Échec de la génération de l'URL de téléchargement	Renvoyé lorsque le serveur échoue à générer une URL de téléchargement signée.