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

Voorbeeld van een foutresponse

Dit is de response voor een API-request waarvoor een onjuiste model-ID is gebruikt:

{
  "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.

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")

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 voor meer informatie.

Fouttypen

Een fout heeft een eigenschap type die aangeeft welk type fout is opgetreden. Zie de onderstaande tabel voor mogelijke waarden.

Foutcodes