Håndter API-feil og retries med CometAPI - CometAPI Documentation

Håndter CometAPI-feil ved å avgjøre om requesten skal rettes eller retries. Retry 429, feil i timeout-klassen og midlertidige serverfeil med backoff; ikke retry feilformede requests eller autentiseringsfeil.

Retry bare feil som kan retries

Status eller signal	Retry?	Handling
`400`	Nei	Rett request body eller parametere.
`401`	Nei	Rett API-nøkkelen og `Authorization`-headeren.
`403`	Vanligvis nei	Fjern felter som ikke støttes og bekreft model-tilgang.
`429`	Ja	Retry med eksponentiell backoff og jitter.
`500` med `invalid_request`	Nei	Rett request-utformingen.
`500`, `503`, `504`, `524`	Ja	Retry med backoff og behold request ID.

Legg til backoff

Følgende Python-eksempel retryer bare feil som kan retries:

import os
import random
import time
from openai import APIError, OpenAI, RateLimitError

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

for attempt in range(5):
    try:
        response = client.chat.completions.create(
            model="your-model-id",
            messages=[{"role": "user", "content": "Say hello."}],
        )
        print(response.choices[0].message.content)
        break
    except RateLimitError:
        delay = min(30, 2**attempt) + random.random()
        time.sleep(delay)
    except APIError as error:
        status_code = getattr(error, "status_code", None)
        if status_code in {500, 503, 504, 524}:
            delay = min(30, 2**attempt) + random.random()
            time.sleep(delay)
            continue
        raise
else:
    raise RuntimeError("The request failed after retries.")

Det vellykkede svaret inkluderer model-utdataene:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello."
      }
    }
  ],
  "usage": {
    "total_tokens": 9
  }
}

Logg nyttig kontekst

Følgende JSON-form er trygg å lagre etter at du har fjernet brukerhemmeligheter og store filer:

{
  "method": "POST",
  "path": "/v1/chat/completions",
  "model": "your-model-id",
  "status": 429,
  "request_id": "request_id_from_error_message",
  "retryable": true
}

Vanlige feil

Feil	Løsning
Retry av `401`	Stopp retries og roter eller last inn API-nøkkelen på nytt.
Retry av ugyldig JSON	Valider request body før du sender en ny request.
Ingen request ID i logger	Fang opp den nøyaktige error body før SDK-en wrapper den.
Umiddelbar retry etter `429`	Legg til jitter og reduser samtidighet.

Relaterte lenker

Sist endret 23. juni 2026