Fouten

Fouten gebruiken de foutstructuur van OpenAI, zodat de officiële SDK's ze omzetten in hun gewone exceptions (APIError, RateLimitError, AuthenticationError enzovoort). Baseer je logica op code; message is een leesbare uitleg in het Engels.

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

Mislukte requests worden niet in rekening gebracht. Een response met een 4xx- of 5xx-status kost niets.

Foutcodes van de gateway

Upstream-fouten

Fouten van de upstream-provider, bijvoorbeeld een ongeldige parameter voor een specifiek model, een te lange context, een weigering op basis van het contentbeleid of een eigen 429 van de provider, worden doorgegeven met hun oorspronkelijke statuscode en dezelfde { error: {... } }-structuur.

Wat te doen

Fouten afhandelen in 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)

Fouten die optreden nadat een stream is begonnen, komen binnen de stream binnen. Zie Streaming.