Erros

Os erros usam o formato de erro da OpenAI, então os SDKs oficiais os transformam em suas exceções normais (APIError, RateLimitError, AuthenticationError e assim por diante). Tome decisões com base em code; message é uma explicação legível em 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"
  }
}

Requisições com falha não são cobradas. Qualquer resposta com status 4xx ou 5xx não custa nada.

Códigos de erro do gateway

Erros do upstream

Erros retornados pelo provedor upstream, por exemplo, um parâmetro inválido para um modelo específico, um estouro do limite de contexto, uma recusa por política de conteúdo ou um 429 do próprio provedor, são repassados com o código de status original e o mesmo formato { error: {... } }.

O que fazer

Tratando erros no 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)

Erros que ocorrem depois que um stream começou chegam dentro do próprio stream. Veja Streaming.