Fehler

Fehler verwenden das OpenAI-Fehlerformat, sodass die offiziellen SDKs sie in ihre üblichen Exceptions umwandeln (APIError, RateLimitError, AuthenticationError usw.). Verzweigen Sie anhand von code; message ist eine für Menschen lesbare Erklärung auf Englisch.

{
  "error": {
    "message": "This request may cost up to $0.0123 but your balance is $0.0040. Add funds at /pricing.",
    "type": "insufficient_quota",
    "code": "insufficient_balance"
  }
}

Fehlgeschlagene Requests werden nicht berechnet. Jede Antwort mit einem 4xx- oder 5xx-Status ist kostenlos.

Fehlercodes des Gateways

Upstream-Fehler

Fehler des Upstream-Anbieters, zum Beispiel ein für ein bestimmtes Modell ungültiger Parameter, eine Überschreitung der Kontextlänge, eine Ablehnung aufgrund von Content-Richtlinien oder ein eigenes 429 des Anbieters, werden mit ihrem ursprünglichen Statuscode und demselben { error: {... } }-Format durchgereicht.

Was zu tun ist

Fehlerbehandlung im Code

import OpenAI from 'openai'

const client = new OpenAI({ baseURL: 'https://api14.com/api/v1', apiKey: process.env.API14_API_KEY })

try {
  await client.chat.completions.create({ model: 'openai/gpt-5-mini', messages: [{ role: 'user', content: 'Hi' }] })
} catch (err) {
  if (err instanceof OpenAI.APIError) {
    console.error(err.status, err.code, err.message)
    if (err.code === 'insufficient_balance') {
      // prompt the user to add funds
    }
  } else {
    throw err
  }
}

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api14.com/api/v1", api_key="sk-api14-...")

try:
    client.chat.completions.create(model="openai/gpt-5-mini", messages=[{"role": "user", "content": "Hi"}])
except APIStatusError as e:
    print(e.status_code, e.code, e.message)

Fehler, die nach Beginn eines Streams auftreten, kommen innerhalb des Streams an. Siehe Streaming.