오류

오류는 OpenAI 오류 형식을 사용하므로 공식 SDK가 이를 일반적인 예외(APIError, RateLimitError, AuthenticationError 등)로 변환합니다. 분기 처리에는 code를 사용하세요. message는 사람이 읽을 수 있도록 영어로 작성된 설명입니다.

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

실패한 요청에는 요금이 부과되지 않습니다. 4xx 또는 5xx 상태의 응답은 무료입니다.

게이트웨이 오류 코드

업스트림 오류

업스트림 제공업체가 반환한 오류(예: 특정 모델에 대한 잘못된 파라미터, 컨텍스트 길이 초과, 콘텐츠 정책에 따른 거부, 제공업체 자체의 429)는 원래 상태 코드와 동일한 { error: { ... } } 형식으로 그대로 전달됩니다.

대응 방법

코드에서 오류 처리하기

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)

스트림이 시작된 뒤 발생한 오류는 스트림 안으로 전달됩니다. 스트리밍을 참고하세요.