Hatalar

Hatalar OpenAI hata yapısını kullanır; böylece resmi SDK'lar bunları her zamanki exception'larına (APIError, RateLimitError, AuthenticationError vb.) dönüştürür. Mantığınızı code üzerine kurun; message, İngilizce ve insanlar için yazılmış bir açıklamadır.

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

Başarısız istekler ücretlendirilmez. 4xx veya 5xx durum kodlu hiçbir yanıt ücret doğurmaz.

Ağ geçidi hata kodları

Upstream hataları

Upstream sağlayıcının döndürdüğü hatalar, örneğin belirli bir model için geçersiz bir parametre, bağlam uzunluğu aşımı, içerik politikası reddi veya sağlayıcının kendi 429 yanıtı, orijinal durum kodları ve aynı { error: {... } } yapısıyla iletilir.

Ne yapmalı

Kodda hataları ele almak

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)

Stream başladıktan sonra oluşan hatalar stream'in içinde gelir. Bkz. Streaming.