Błędy

Błędy mają strukturę błędów OpenAI, więc oficjalne SDK zamieniają je na swoje zwykłe wyjątki (APIError, RateLimitError, AuthenticationError i tak dalej). Opieraj logikę na polu code; message to czytelne wyjaśnienie po angielsku.

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

Za nieudane żądania nie płacisz. Każda odpowiedź ze statusem 4xx lub 5xx jest bezpłatna.

Kody błędów bramki

Błędy upstream

Błędy zwrócone przez dostawcę upstream, na przykład nieprawidłowy parametr dla konkretnego modelu, przekroczenie długości kontekstu, odmowa z powodu zasad dotyczących treści czy własny 429 dostawcy, są przekazywane z oryginalnym kodem statusu i tą samą strukturą { error: {... } }.

Co zrobić

Obsługa błędów w kodzie

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)

Błędy, które wystąpią po rozpoczęciu strumienia, docierają wewnątrz strumienia. Zobacz Streaming.