> 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. # Fouten ## API-fouten ElevenLabs gebruikt standaard HTTP-statuscodes om aan te geven of een request is geslaagd of mislukt. Daarnaast retourneren alle API-requests een JSON-object met een eigenschap `detail` die informatie over de fout bevat. Over het algemeen geeft een HTTP-statuscode `200` een geslaagd request aan. Een code `4xx` wijst op een probleem met het request, zoals een ongeldige parameter of een ontbrekend verplicht veld. Een HTTP-statuscode `500` wijst op een probleem met de servers van ElevenLabs, wat zelden zou moeten voorkomen. ### Fouteigenschappen | Eigenschap | Beschrijving | | ------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `type` | Het type fout dat is opgetreden. Zie de onderstaande tabel voor mogelijke waarden. | | `code` | De code van de fout. Deze zijn specifieker dan het type en kunnen worden gebruikt om de oorzaak van de fout te bepalen. | | `message` | Het foutbericht. Dit geeft meer informatie over de fout. | | `status` | De status van de fout. Dit is een verouderd veld dat niet meer wordt gebruikt; gebruik in plaats daarvan de eigenschap `code`. | | `request_id` | De request-ID van de fout. Dit is een unieke identifier voor het request die je kunt gebruiken om de fout op te lossen. | | `param` | De parameter die de fout heeft veroorzaakt. Bij een validatiefout geeft dit aan welke parameter ongeldig is. | ### Voorbeeld van een foutresponse Dit is de response voor een API-request waarvoor een onjuiste model-ID is gebruikt: ```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" } } ``` Aan de hand van de fouteigenschappen zien we dat het om een validatiefout gaat en dat de code `invalid_parameters` is. Het bericht geeft meer informatie over de fout en de `request_id` is een unieke identifier voor het request die je kunt gebruiken om de fout op te lossen. De eigenschap `param` geeft de parameter aan die de fout heeft veroorzaakt. ### Foutafhandeling in SDK's De ElevenLabs SDK's bieden getypeerde foutklassen waarmee je toegang krijgt tot de foutdetails. ```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"); } } } } ``` Als je de fout niet kunt oplossen, stuur dan een e-mail naar Support via [support@elevenlabs.io](mailto:support@elevenlabs.io) met de `request_id` uit de foutresponse, het volledige foutbericht en stappen om het probleem te reproduceren. #### Rate limiting en concurrency Als je een HTTP-statuscode 429 ontvangt, betekent dit dat je te veel requests in korte tijd hebt gedaan en de ratelimiet voor het API-endpoint hebt overschreden, of dat je de concurrencylimiet voor het API-endpoint hebt overschreden. De fout-`code` is respectievelijk `rate_limit_exceeded` of `concurrent_limit_exceeded`. Bij rate limiting moet je exponential backoff in je code implementeren wanneer je een 429-fout ontvangt. Dit betekent dat je een vertraging toevoegt voordat je het request opnieuw probeert. Bij concurrency moet je wachten tot de huidige requests zijn voltooid voordat je nieuwe doet. Zie het gedeelte [Concurrency en prioriteit](/docs/nl/overview/models#concurrency-and-priority) voor meer informatie. ### Fouttypen Een fout heeft een eigenschap `type` die aangeeft welk type fout is opgetreden. Zie de onderstaande tabel voor mogelijke waarden. | Type | Beschrijving | HTTP-statuscode | | ---------------------- | ----------------------------------------------------------------------------- | --------------- | | `validation_error` | Het request bevat ongeldige parameterwaarden. | 400 | | `invalid_request` | De structuur van het request is onjuist of verplichte velden ontbreken. | 400 | | `authentication_error` | Authenticatie is mislukt - ongeldige of ontbrekende API-sleutel/token. | 401 | | `payment_required` | De gebruiker heeft onvoldoende credits of betaling is vereist. | 402 | | `authorization_error` | De geauthenticeerde gebruiker heeft niet de vereiste rechten voor deze actie. | 403 | | `not_found` | De opgevraagde resource is niet gevonden. | 404 | | `conflict` | Het request conflicteert met de huidige status van de resource. | 409 | | `rate_limit_error` | Te veel requests - probeer het later opnieuw. | 429 | | `internal_error` | Er is een onverwachte serverfout opgetreden. | 500 | | `service_unavailable` | De service is tijdelijk niet beschikbaar; dit zou zelden moeten voorkomen. | 503 | ### Foutcodes
Code Type Beschrijving
`voice_not_found` `not_found` De opgegeven stem-ID bestaat niet. Controleer de stem-ID en probeer het opnieuw.
`sample_not_found` `not_found` Het opgegeven stemvoorbeeld is niet gevonden.
`voice_collection_not_found` `not_found` De opgegeven stemcollectie bestaat niet.
`user_not_found` `not_found` De opgegeven gebruiker is niet gevonden.
`auth_account_not_found` `not_found` Het authenticatieaccount is niet gevonden.
`workspace_not_found` `not_found` De opgegeven workspace bestaat niet.
`project_not_found` `not_found` Het opgegeven project is niet gevonden.
`history_item_not_found` `not_found` Het opgegeven geschiedenisitem bestaat niet.
`collection_not_found` `not_found` De opgegeven collectie is niet gevonden.
`document_not_found` `not_found` Het opgegeven document bestaat niet.
`file_not_found` `not_found` Het opgegeven bestand is niet gevonden.
`conversation_not_found` `not_found` Het opgegeven gesprek bestaat niet.
`agent_not_found` `not_found` De opgegeven agent is niet gevonden.
`dubbing_not_found` `not_found` Het opgegeven nasynchronisatieproject bestaat niet.
`song_not_found` `not_found` Het opgegeven nummer is niet gevonden.
`read_not_found` `not_found` De opgegeven read is niet gevonden.
`pronunciation_dictionary_not_found` `not_found` Het opgegeven uitspraakwoordenboek bestaat niet.
`knowledge_base_not_found` `not_found` De opgegeven kennisbank is niet gevonden.
`phone_number_not_found` `not_found` Het opgegeven telefoonnummer bestaat niet.
`tool_not_found` `not_found` De opgegeven tool is niet gevonden.
`snapshot_not_found` `not_found` De opgegeven snapshot bestaat niet.
`task_not_found` `not_found` De opgegeven taak is niet gevonden.
`model_not_found` `not_found` Het opgegeven model bestaat niet.
`transcript_not_found` `not_found` Het opgegeven transcript is niet gevonden.
`keywords_list_not_found` `not_found` De opgegeven lijst met zoekwoorden is niet gevonden.
`category_not_found` `not_found` De opgegeven categorie is niet gevonden.
`text_too_long` `validation_error` De opgegeven tekst is langer dan de maximaal toegestane lengte.
`text_too_short` `validation_error` De opgegeven tekst is korter dan de minimaal vereiste lengte.
`invalid_text` `validation_error` De opgegeven tekst bevat ongeldige tekens of opmaak.
`empty_text` `validation_error` Het tekstveld mag niet leeg zijn.
`invalid_parameters` `validation_error` Een of meer requestparameters zijn ongeldig. Controleer de eigenschap `param` op de ongeldige parameter.
`missing_required_field` `validation_error` Een verplicht veld ontbreekt in het request. Controleer de eigenschap `param` op het ontbrekende veld.
`invalid_voice_settings` `validation_error` De steminstellingen bevatten ongeldige waarden. Controleer de eigenschap `param` op de ongeldige stem- instellingen.
`invalid_voice_id` `validation_error` De indeling van de stem-ID is ongeldig.
`unsupported_model` `validation_error` Het opgegeven model wordt niet ondersteund voor deze bewerking.
`invalid_audio` `validation_error` De opgegeven audio is ongeldig of beschadigd.
`invalid_audio_format` `validation_error` Het opgegeven audioformaat wordt niet ondersteund.
`invalid_output_format` `validation_error` Het opgevraagde uitvoerformaat wordt niet ondersteund.
`audio_too_long` `validation_error` De audio overschrijdt de maximaal toegestane duur.
`audio_too_short` `validation_error` De audio is korter dan de minimaal vereiste duur.
`invalid_file_type` `validation_error` Het bestandstype wordt niet ondersteund.
`invalid_page_size` `validation_error` De parameter voor de paginagrootte valt buiten het toegestane bereik.
`invalid_cursor` `validation_error` De pagineringscursor is ongeldig of verlopen.
`bad_request` `invalid_request` De server kon het request niet begrijpen.
`malformed_json` `invalid_request` De requestbody bevat ongeldige JSON.
`invalid_content_type` `invalid_request` De header Content-Type ontbreekt of is ongeldig.
`request_too_large` `invalid_request` De requestbody overschrijdt de maximaal toegestane grootte.
`invalid_api_key` `authentication_error` De opgegeven API-sleutel is ongeldig.
`missing_api_key` `authentication_error` Er is geen API-sleutel opgegeven in het request.
`invalid_authorization_header` `authentication_error` De indeling van de Authorization-header is ongeldig.
`unauthorized` `authentication_error` Authenticatie is vereist om toegang te krijgen tot deze resource.
`sign_in_required` `authentication_error` Je moet ingelogd zijn om deze actie uit te voeren.
`forbidden` `authorization_error` Toegang tot deze resource is verboden.
`insufficient_permissions` `authorization_error` Je hebt niet de vereiste rechten voor deze actie.
`workspace_access_denied` `authorization_error` Je hebt geen toegang tot deze workspace.
`feature_not_available` `authorization_error` Deze functie is niet beschikbaar in je huidige abonnement.
`subscription_required` `authorization_error` Een betaald abonnement is vereist om toegang te krijgen tot deze functie.
`voice_access_denied` `authorization_error` Je hebt geen toegang tot deze stem.
`model_access_denied` `authorization_error` Je hebt geen toegang tot dit model.
`conflict` `conflict` Er is een conflict opgetreden.
`resource_already_exists` `conflict` Er bestaat al een resource met dezelfde identifier.
`voice_already_exists` `conflict` Er bestaat al een stem met deze naam.
`already_running` `conflict` De bewerking wordt al uitgevoerd.
`already_processing` `conflict` De resource wordt al verwerkt.
`concurrent_modification` `conflict` De resource is gewijzigd door een ander request. Probeer het opnieuw met de nieuwste versie.
`slug_already_exists` `conflict` Er bestaat al een resource met deze slug.
`rate_limit_exceeded` `rate_limit_error` Te veel requests. Wacht voordat je het opnieuw probeert.
`concurrent_limit_exceeded` `rate_limit_error` Het maximale aantal gelijktijdige requests is overschreden. Hogere abonnementsniveaus hebben een hogere concurrencylimiet.
`system_busy` `rate_limit_error` Het systeem is momenteel bezig. Probeer het later opnieuw.
`insufficient_credits` `payment_required` Je account heeft niet genoeg credits voor deze bewerking.
`internal_error` `internal_error` Er is een onverwachte fout opgetreden. Neem contact op met support als dit aanhoudt.
`service_unavailable` `service_unavailable` De service is tijdelijk niet beschikbaar. Probeer het later opnieuw.
`maintenance` `service_unavailable` De service ondergaat gepland onderhoud.