Ошибки и лимиты

Ошибки, порождаемые GetVibe на /v1/*, имеют JSON-конверт с error.message, error.type и error.code. Не полагайтесь на текст сообщения или заголовки сторонних сервисов как на контракт.

{
  "error": {
    "message": "insufficient balance",
    "type": "insufficient_quota",
    "code": 402,
    "request_id": "8d4b6b3a-..."
  }
}

Каждая ошибка запроса содержит стабильный error.code из таблицы ниже, error.param с именем поля, к которому она относится (null, если модель его не указала), и ссылку на соответствующую строку в конце error.message — Codex и другие CLI показывают только сообщение, поэтому ссылка размещена в нём.

Медленный поток (stream: true) получает комментарии 200 и : pv-keepalive после 5 секунд молчания, чтобы соединение не выглядело мёртвым; долгий нестриминговый запрос получает 200 и пробелы после первого токена. С этого момента статус измениться не может, а ошибка приходит в теле. Если ваш клиент при ошибке HTTP переключается на другого поставщика, отправьте x-pv-honest-errors: 1 (или попросите поддержку включить это для аккаунта): тогда нет ни keepalive, ни раннего 200 до первого байта ответа, и каждая ошибка — обычный HTTP-статус с телом JSON. Цена — молчащий сокет до первого токена; ваш тайм-аут заголовков должен это покрывать.

Ошибка после начала ответа — это одно терминальное событие: для chat event: error с {"error":{message,type,code,status},"choices":[{"finish_reason":"error"}]}, за которым следует data: [DONE]; для /v1/responses event: response.failed, несущее тот же error; для /v1/messages — event: error от Anthropic. code — это машинная причина, а status — HTTP-статус, который был бы у ошибки, если бы она возникла до начала ответа.

Оба лимита зависят от текущего баланса аккаунта и применяются ко всем его API-ключам в совокупности. Уровень пересчитывается автоматически: при пополнении баланса лимит повышается, а при снижении баланса ниже порогового значения уровень понижается. Лимита токенов в минуту (TPM) нет.

Для повторяемого ответа сначала используйте Retry-After, если он присутствует. Без этого заголовка не считайте никакой 429 или 503 автоматически повторяемым: проверьте статус HTTP и публичный error.type, устраните непреодолимую причину и применяйте ограниченный backoff только для временной ошибки.

import time, requests

def call_with_retry(url, headers, payload, max_retries=5):
    for attempt in range(max_retries):
        r = requests.post(url, headers=headers, json=payload)
        if r.status_code == 429:
            # honor Retry-After, otherwise exponential backoff
            wait = int(r.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        return r
    return r