Для ШІ-агентів: покрокова інструкція з налаштування — /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 із заголовків відповіді.