> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Erreurs ## Erreurs d’API ElevenLabs utilise des codes d’état HTTP standard pour indiquer si une requête a réussi ou échoué. De plus, toutes les requêtes API renvoient un objet JSON doté d’une propriété `detail` qui contient des informations sur l’erreur. En règle générale, un code d’état HTTP `200` indique qu’une requête a réussi. Un code `4xx` indique un problème dans la requête, comme un paramètre non valide ou un champ obligatoire manquant. Un code d’état HTTP `500` indique un problème sur les serveurs d’ElevenLabs, ce qui devrait être rare. ### Propriétés des erreurs | Propriété | Description | | ------------ | -------------------------------------------------------------------------------------------------------- | | `type` | Le type d’erreur survenue. Consultez le tableau ci-dessous pour connaître les valeurs possibles. | | `code` | Le code de l’erreur. Plus précis que le type, il permet d’en déterminer la cause. | | `message` | Le message d’erreur. Il fournit davantage de détails sur l’erreur. | | `status` | L’état de l’erreur. Ce champ historique n’est plus utilisé, utilisez plutôt la propriété `code`. | | `request_id` | L’ID de requête de l’erreur. Cet identifiant unique permet de résoudre le problème. | | `param` | Le paramètre à l’origine de l’erreur. En cas d’erreur de validation, il indique le paramètre non valide. | ### Exemple de réponse d’erreur Voici la réponse d’une requête API ayant utilisé un ID de modèle incorrect : ```json { "detail": { "type": "validation_error", "code": "invalid_parameters", "message": "The 'keyterms' parameter is only supported with the 'scribe_v2' model. You specified 'scribe_v1'.", "status": "invalid_parameters", "request_id": "3c807fc4c3a1705f9638ecc764a91c01", "param": "keyterms" } } ``` Les propriétés de l’erreur indiquent qu’il s’agit d’une erreur de validation et que son code est `invalid_parameters`. Le message fournit davantage de détails, tandis que `request_id` est un identifiant unique de la requête permettant de résoudre le problème. La propriété `param` indique le paramètre à l’origine de l’erreur. ### Gestion des erreurs dans les SDK Les SDK ElevenLabs fournissent des classes d’erreur typées qui vous donnent accès aux détails de l’erreur. ```python from elevenlabs import ElevenLabs from elevenlabs.core import ApiError elevenlabs = ElevenLabs() try: audio = elevenlabs.text_to_speech.convert( voice_id="invalid-voice-id", model_id="eleven_v4", text="Hello, world!", ) except ApiError as e: print(f"Status code: {e.status_code}") # Access the error body if e.body and "detail" in e.body: detail = e.body["detail"] print(f"Error type: {detail.get('type')}") print(f"Error code: {detail.get('code')}") print(f"Message: {detail.get('message')}") print(f"Request ID: {detail.get('request_id')}") # Handle specific error types if detail.get("type") == "rate_limit_error": print("Rate limited - implement exponential backoff") elif detail.get("type") == "authentication_error": print("Check your API key") ``` ```typescript import { ElevenLabsClient, ElevenLabsError } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); try { const audio = await elevenlabs.textToSpeech.convert("invalid-voice-id", { text: "Hello, world!", modelId: "eleven_v4", }); } catch (error) { if (error instanceof ElevenLabsError) { console.log(`Status code: ${error.statusCode}`); // Access the error body const detail = (error.body as any)?.detail; if (detail) { console.log(`Error type: ${detail.type}`); console.log(`Error code: ${detail.code}`); console.log(`Message: ${detail.message}`); console.log(`Request ID: ${detail.request_id}`); // Handle specific error types if (detail.type === "rate_limit_error") { console.log("Rate limited - implement exponential backoff"); } else if (detail.type === "authentication_error") { console.log("Check your API key"); } } } } ``` Si vous ne parvenez pas à résoudre l’erreur, envoyez un email au support à l’adresse [support@elevenlabs.io](mailto:support@elevenlabs.io) avec le `request_id` de la réponse d’erreur, le message d’erreur complet et les étapes permettant de reproduire le problème. #### Limitation de débit et requêtes simultanées Si vous recevez un code d’état HTTP 429, cela signifie que vous avez soit effectué trop de requêtes sur une courte période et dépassé la limite de débit de l’endpoint API, soit dépassé la limite de requêtes simultanées de cet endpoint. Le `code` de l’erreur sera respectivement `rate_limit_exceeded` ou `concurrent_limit_exceeded`. En cas de limitation de débit, implémentez un backoff exponentiel dans votre code lorsqu’une erreur 429 est reçue. Cela consiste à ajouter un délai avant de réessayer la requête. En cas de limite de requêtes simultanées, attendez que les requêtes en cours soient terminées avant d’en effectuer de nouvelles. Consultez la section [Requêtes simultanées et priorité](/docs/fr/overview/models#concurrency-and-priority) pour en savoir plus. ### Types d’erreur Une erreur comporte une propriété `type` indiquant le type d’erreur survenue. Consultez le tableau ci-dessous pour connaître les valeurs possibles. | Type | Description | Code d’état HTTP | | ---------------------- | ------------------------------------------------------------------------------ | ---------------- | | `validation_error` | La requête contient des valeurs de paramètres non valides. | 400 | | `invalid_request` | La structure de la requête est mal formée ou des champs obligatoires manquent. | 400 | | `authentication_error` | L’authentification a échoué, clé API ou jeton non valide ou manquant. | 401 | | `payment_required` | L’utilisateur ne dispose pas de crédits suffisants ou un paiement est requis. | 402 | | `authorization_error` | L’utilisateur authentifié ne dispose pas des autorisations requises. | 403 | | `not_found` | La ressource demandée est introuvable. | 404 | | `conflict` | La requête entre en conflit avec l’état actuel de la ressource. | 409 | | `rate_limit_error` | Trop de requêtes, réessayez plus tard. | 429 | | `internal_error` | Une erreur serveur inattendue est survenue. | 500 | | `service_unavailable` | Le service est temporairement indisponible, ce qui devrait être rare. | 503 | ### Codes d’erreur
Code Type Description
`voice_not_found` `not_found` L’ID de voix indiqué n’existe pas. Vérifiez l’ID de voix et réessayez.
`sample_not_found` `not_found` L’échantillon vocal indiqué est introuvable.
`voice_collection_not_found` `not_found` La collection de voix indiquée n’existe pas.
`user_not_found` `not_found` L’utilisateur indiqué est introuvable.
`auth_account_not_found` `not_found` Le compte d’authentification est introuvable.
`workspace_not_found` `not_found` Le Workspace indiqué n’existe pas.
`project_not_found` `not_found` Le projet indiqué est introuvable.
`history_item_not_found` `not_found` L’élément d’historique indiqué n’existe pas.
`collection_not_found` `not_found` La collection indiquée est introuvable.
`document_not_found` `not_found` Le document indiqué n’existe pas.
`file_not_found` `not_found` Le fichier indiqué est introuvable.
`conversation_not_found` `not_found` La conversation indiquée n’existe pas.
`agent_not_found` `not_found` L’agent indiqué est introuvable.
`dubbing_not_found` `not_found` Le projet de doublage indiqué n’existe pas.
`song_not_found` `not_found` La chanson indiquée est introuvable.
`read_not_found` `not_found` La lecture indiquée est introuvable.
`pronunciation_dictionary_not_found` `not_found` Le dictionnaire de prononciation indiqué n’existe pas.
`knowledge_base_not_found` `not_found` La base de connaissances indiquée est introuvable.
`phone_number_not_found` `not_found` Le numéro de téléphone indiqué n’existe pas.
`tool_not_found` `not_found` L’outil indiqué est introuvable.
`snapshot_not_found` `not_found` L’instantané indiqué n’existe pas.
`task_not_found` `not_found` La tâche indiquée est introuvable.
`model_not_found` `not_found` Le modèle indiqué n’existe pas.
`transcript_not_found` `not_found` La transcription indiquée est introuvable.
`keywords_list_not_found` `not_found` La liste de mots-clés indiquée est introuvable.
`category_not_found` `not_found` La catégorie indiquée est introuvable.
`text_too_long` `validation_error` Le texte fourni dépasse la longueur maximale autorisée.
`text_too_short` `validation_error` Le texte fourni est plus court que la longueur minimale requise.
`invalid_text` `validation_error` Le texte fourni contient des caractères ou une mise en forme non valides.
`empty_text` `validation_error` Le champ de texte ne peut pas être vide.
`invalid_parameters` `validation_error` Un ou plusieurs paramètres de requête ne sont pas valides. Consultez la propriété `param` pour connaître le paramètre non valide.
`missing_required_field` `validation_error` Un champ obligatoire est absent de la requête. Consultez la propriété `param` pour connaître le champ manquant.
`invalid_voice_settings` `validation_error` Les paramètres vocaux contiennent des valeurs non valides. Consultez la propriété `param` pour connaître les paramètres vocaux non valides.
`invalid_voice_id` `validation_error` Le format de l’ID de voix n’est pas valide.
`unsupported_model` `validation_error` Le modèle indiqué n’est pas pris en charge pour cette opération.
`invalid_audio` `validation_error` L’audio fourni n’est pas valide ou est corrompu.
`invalid_audio_format` `validation_error` Le format audio indiqué n’est pas pris en charge.
`invalid_output_format` `validation_error` Le format de sortie demandé n’est pas pris en charge.
`audio_too_long` `validation_error` L’audio dépasse la durée maximale autorisée.
`audio_too_short` `validation_error` L’audio est plus court que la durée minimale requise.
`invalid_file_type` `validation_error` Ce type de fichier n’est pas pris en charge.
`invalid_page_size` `validation_error` Le paramètre de taille de page est hors de la plage autorisée.
`invalid_cursor` `validation_error` Le curseur de pagination n’est pas valide ou a expiré.
`bad_request` `invalid_request` Le serveur n’a pas pu interpréter la requête.
`malformed_json` `invalid_request` Le corps de la requête contient du JSON non valide.
`invalid_content_type` `invalid_request` L’en-tête Content-Type est absent ou non valide.
`request_too_large` `invalid_request` Le corps de la requête dépasse la taille maximale autorisée.
`invalid_api_key` `authentication_error` La clé API fournie n’est pas valide.
`missing_api_key` `authentication_error` Aucune clé API n’a été fournie dans la requête.
`invalid_authorization_header` `authentication_error` Le format de l’en-tête Authorization n’est pas valide.
`unauthorized` `authentication_error` Une authentification est requise pour accéder à cette ressource.
`sign_in_required` `authentication_error` Vous devez être connecté pour effectuer cette action.
`forbidden` `authorization_error` L’accès à cette ressource est interdit.
`insufficient_permissions` `authorization_error` Vous ne disposez pas des autorisations requises pour cette action.
`workspace_access_denied` `authorization_error` Vous n’avez pas accès à ce Workspace.
`feature_not_available` `authorization_error` Cette fonctionnalité n’est pas disponible avec votre forfait actuel.
`subscription_required` `authorization_error` Un abonnement payant est requis pour accéder à cette fonctionnalité.
`voice_access_denied` `authorization_error` Vous n’avez pas accès à cette voix.
`model_access_denied` `authorization_error` Vous n’avez pas accès à ce modèle.
`conflict` `conflict` Un conflit est survenu.
`resource_already_exists` `conflict` Une ressource avec le même identifiant existe déjà.
`voice_already_exists` `conflict` Une voix portant ce nom existe déjà.
`already_running` `conflict` L’opération est déjà en cours.
`already_processing` `conflict` La ressource est déjà en cours de traitement.
`concurrent_modification` `conflict` La ressource a été modifiée par une autre requête. Réessayez avec la version la plus récente.
`slug_already_exists` `conflict` Une ressource avec ce slug existe déjà.
`rate_limit_exceeded` `rate_limit_error` Trop de requêtes. Attendez avant de réessayer.
`concurrent_limit_exceeded` `rate_limit_error` Nombre maximal de requêtes simultanées dépassé. Les forfaits supérieurs offrent une limite de requêtes simultanées plus élevée.
`system_busy` `rate_limit_error` Le système est actuellement occupé. Réessayez plus tard.
`insufficient_credits` `payment_required` Votre compte ne dispose pas de suffisamment de crédits pour cette opération.
`internal_error` `internal_error` Une erreur inattendue est survenue. Contactez le support si le problème persiste.
`service_unavailable` `service_unavailable` Le service est temporairement indisponible. Réessayez plus tard.
`maintenance` `service_unavailable` Le service fait l’objet d’une maintenance planifiée.