Errori

Gli errori usano il formato di errore di OpenAI, quindi gli SDK ufficiali li trasformano nelle loro normali eccezioni (APIError, RateLimitError, AuthenticationError e così via). Basa la tua logica su code; message è una spiegazione leggibile in inglese.

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

Le richieste non riuscite non vengono addebitate. Qualsiasi risposta con stato 4xx o 5xx non costa nulla.

Codici di errore del gateway

Errori dell'upstream

Gli errori restituiti dal provider upstream, ad esempio un parametro non valido per un modello specifico, il superamento della lunghezza del contesto, un rifiuto per policy sui contenuti o un 429 del provider stesso, vengono inoltrati con il codice di stato originale e lo stesso formato { error: {... } }.

Cosa fare

Gestire gli errori nel codice

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)

Gli errori che si verificano dopo l'inizio di uno stream arrivano all'interno dello stream stesso. Vedi Streaming.