Erreurs

Les erreurs suivent le format d'erreur d'OpenAI : les SDK officiels les convertissent donc en leurs exceptions habituelles (APIError, RateLimitError, AuthenticationError, etc.). Basez votre logique sur code ; message est une explication lisible en anglais.

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

Les requêtes en échec ne sont pas facturées. Toute réponse avec un statut 4xx ou 5xx ne coûte rien.

Codes d'erreur de la passerelle

Erreurs du fournisseur en amont

Les erreurs renvoyées par le fournisseur en amont (par exemple un paramètre invalide pour un modèle donné, un dépassement de la longueur de contexte, un refus lié à la politique de contenu ou un 429 du fournisseur lui-même) sont transmises avec leur code de statut d'origine et le même format { error: { ... } }.

Que faire

Gérer les erreurs dans le 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)

Les erreurs qui surviennent après le début d'un flux arrivent à l'intérieur du flux. Voir Streaming.