Fel

API-fel

ElevenLabs använder vanliga HTTP-statuskoder för att ange om en begäran lyckades eller misslyckades. Dessutom returnerar alla API-begäranden ett JSON-objekt med egenskapen detail, som innehåller information om felet.

Generellt innebär HTTP-statuskoden 200 att begäran lyckades. En 4xx-kod anger ett problem med begäran, till exempel en ogiltig parameter eller ett saknat obligatoriskt fält. HTTP-statuskoden 500 anger ett problem med ElevenLabs servrar, vilket bör vara ovanligt.

Felegenskaper

Exempel på felsvar

Här är svaret för en API-begäran som använde ett felaktigt modell-ID:

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

Med hjälp av felegenskaperna ser vi att felet är ett valideringsfel och att koden är invalid_parameters. Meddelandet ger mer information om felet, och request_id är en unik identifierare för begäran som kan användas för att felsöka felet. Egenskapen param anger parametern som orsakade felet.

Felhantering i SDK:er

ElevenLabs SDK:er har typade felklasser som ger dig åtkomst till felinformationen.

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

Hastighetsbegränsning och samtidighet

Om du får HTTP-statuskoden 429 betyder det att du antingen har gjort för många begäranden under en kort tidsperiod och överskridit hastighetsgränsen för API-slutpunkten, eller att du har överskridit samtidighetsgränsen för API-slutpunkten. Felkoden code blir då rate_limit_exceeded respektive concurrent_limit_exceeded.

Vid hastighetsbegränsning bör du implementera exponentiell backoff i din kod när du får ett 429-fel. Det innebär att lägga till en fördröjning innan du försöker igen.

Vid samtidighetsbegränsning bör du vänta tills de pågående begärandena har slutförts innan du gör nya. Läs mer i avsnittet Samtidighet och prioritet.

Feltyper

Ett fel har egenskapen type som anger vilken typ av fel som inträffade. Se tabellen nedan för möjliga värden.

Felkoder