Errores

Los errores usan el formato de error de OpenAI, así que los SDK oficiales los convierten en sus excepciones habituales (APIError, RateLimitError, AuthenticationError, etc.). Toma decisiones según code; message es una explicación legible en inglés.

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

Las peticiones fallidas no se cobran. Cualquier respuesta con un estado 4xx o 5xx no cuesta nada.

Códigos de error de la pasarela

Errores del upstream

Los errores que devuelve el proveedor upstream (por ejemplo, un parámetro no válido para un modelo concreto, un desbordamiento de la longitud de contexto, un rechazo por política de contenido o un 429 del propio proveedor) se reenvían con su código de estado original y el mismo formato { error: { ... } }.

Qué hacer

Gestionar errores en el código

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)

Los errores que se producen después de que haya empezado un stream llegan dentro del propio stream. Consulta Streaming.