Ошибки

aicentos полностью придерживается формата ошибок OpenAI. Если ошибку бросает SDK, достаточно перехватить соответствующее исключение.

Структура ответа с ошибкойКопировать ссылку на якорь

Все ответы с ошибкой имеют такой вид:

{
  "error": {
    "message": "У вашего API-ключа нет доступа к gpt-5",
    "type": "permission_denied",
    "code": "model_not_allowed",
    "param": "model"
  }
}

Шпаргалка по HTTP-кодамКопировать ссылку на якорь

Частые ошибки и решенияКопировать ссылку на якорь

401 — Invalid API keyКопировать ссылку на якорь

{ "error": { "message": "Incorrect API key provided", "type": "authentication_error" } }

Чек-лист проверки:

• Заголовок Authorization в формате Bearer sk-xxx (важен пробел)
• Не попали ли в ключ пробелы / переводы строк при копировании из консоли
• Не удалён ли ключ / не отключён ли / не истёк ли срок его действия
• Не оказался ли тестовый ключ в продакшене

402 — Insufficient quotaКопировать ссылку на якорь

{ "error": { "message": "Insufficient quota", "type": "insufficient_quota" } }

Пополните баланс: консоль → «Кошелёк». Включите предупреждение о балансе, чтобы ситуация не повторилась.

403 — Model not allowedКопировать ссылку на якорь

{ "error": { "message": "Model gpt-5 not allowed for this key", "code": "model_not_allowed" } }

При создании токена был отмечен белый список «доступные модели», и запрошенная model в него не входит. Измените настройки токена или возьмите другой ключ.

404 — Model not foundКопировать ссылку на якорь

{ "error": { "message": "The model 'gpt-4-turbo-2024-04-09' does not exist", "code": "model_not_found" } }

ID модели указан с опечаткой либо модель снята с обслуживания. Актуальные доступные ID смотрите в витрине моделей.

429 — Rate limit exceededКопировать ссылку на якорь

Заголовок ответа Retry-After подсказывает, через сколько секунд повторить запрос. Достаточно снизить параллелизм и частоту запросов — и всё восстановится.

500 / 502 / 503 — сбой сервисаКопировать ссылку на якорь

Обычно это колебания апстрима. 2–3 автоматических повтора чаще всего решают проблему. Если длится дольше 5 минут:

• проверьте страницу статуса (если доступна)
• обратитесь в поддержку

408 / 504 — таймаутыКопировать ссылку на якорь

Запрос висит без ответа дольше 60 с. Частые причины:

• слишком длинный prompt — модель «думает» дольше таймаута
• не включён стриминг (для длинных ответов добавьте stream: true)

Решение:

• сократите prompt
• включите стриминг: { "model": "...", "messages": [...], "stream": true }
• переключитесь на более быструю модель (например, с gpt-4o на gpt-4o-mini)

Примеры обработки ошибок в SDKКопировать ссылку на якорь

export AICENTOS_API_KEY="sk-your-aicentos-api-key"

PythonКопировать ссылку на якорь

import os
from openai import OpenAI, APIError, RateLimitError, AuthenticationError

client = OpenAI(api_key=os.environ["AICENTOS_API_KEY"], base_url="https://aicentos.com/v1")

try:
    resp = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "hi"}],
    )
except AuthenticationError:
    print("Неверный ключ")
except RateLimitError as e:
    print(f"Лимит запросов, повтор через {e.response.headers.get('Retry-After')} с")
except APIError as e:
    print(f"Другая ошибка API: {e.status_code} {e.message}")

Node.jsКопировать ссылку на якорь

import OpenAI, { APIError } from 'openai';

const client = new OpenAI({
  apiKey: process.env.AICENTOS_API_KEY,
  baseURL: 'https://aicentos.com/v1',
});

try {
  const resp = await client.chat.completions.create({ ... });
} catch (err) {
  if (err instanceof APIError) {
    console.log(err.status, err.code, err.message);
  }
}

Рекомендации по повторам и деградацииКопировать ссылку на якорь

В официальных SDK OpenAI по умолчанию заложена разумная политика повторов — в продакшене используйте SDK, а не собственный fetch.