Для ИИ-агентов: пошаговая инструкция по настройке — /docs/agents.md, индекс документации — /llms.txt.

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

Лимиты запросов, таймауты и коды ошибок шлюза. Для каждого ответа сказано, когда он возникает и что делать: повторить запрос или исправить его.

Числа — из поля limits ответа GET /v1/capabilities: там всегда актуальные значения.

Длина ответа по моделям#

Без max_tokens шлюз подставляет умолчание: без стрима — короче, чтобы ответ уложился в таймауты, в стриме — потолок модели. max_completion_tokens — то же поле.

Тело ошибки — объект error с полями message, type, code, param; часть полей есть не у всех ошибок. Ориентируйтесь на статус и type, уточняйте по code: текст message может меняться. Формат Anthropic — в разделе Формат ошибок Anthropic.

{
  "error": {
    "message": "Model is currently overloaded in the Gonka network",
    "type": "rate_limit_exceeded",
    "code": "upstream_rate_limited"
  }
}

Пока поток не открыт, отказ приходит обычным кодом ответа — как без стрима. После открытия статус уже 200, и ошибка приходит так:

• Chat Completions — чанк joingonka-error с полем error, затем обрыв без [DONE].
• Без стрима после раннего ответа — статус 200 и тело с полем error.
• Anthropic Messages — событие event: error, затем поток закрывается.
• OpenAI Responses — событие response.failed, причина в response.error.code.
• Legacy Completions — data: {"error": …}, затем [DONE].

data: {"id":"joingonka-error","object":"chat.completion.chunk","model":"MiniMaxAI/MiniMax-M2.7","choices":[],"error":{"message":"Gonka network error","type":"api_error"}}

• POST /v1/messages отвечает конвертом Anthropic: {"type": "error", "error": {"type", "message"}}.
• Отказы шлюза сохраняют type из таблицы выше (insufficient_funds, model_unavailable и другие); поля code в этом конверте нет — причина в тексте.
• Ошибки формы запроса — invalid_request_error: нет сообщений или max_tokens, вызов инструмента без имени, неизвестная модель.
• Неизвестный путь — not_found_error, слишком большое тело — request_too_large.

event: error
data: {"type":"error","error":{"type":"timeout","message":"Upstream timeout"}}

• После паузы из Retry-After: 429
• С нарастающей паузой — 1, 2, 4 с и дальше: 500, 502, 503 service_unavailable, 504
• С другой моделью: 503 model_unavailable
• Не повторять без изменений — исправьте запрос, ключ или баланс: 400, 401, 402, 403, 404, 413, 415, 501

Каждый повтор после 504 — новое списание оценки входа; для длинных ответов включайте stream: true.

Ошибка повторяется — напишите в поддержку и приложите x-request-id из заголовков ответа.