Использование

Квоты подключений

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

Получение квоты

Shell

curl --fail-with-body https://ai-router.foodpicasso.dev/v1/limits \
  -H "Authorization: Bearer $PICASSO_TOKEN"

Допустим только GET без query parameters. Тот же ответ доступен по /api/v1/limits, /api/coding/paas/v4/limits и /api/anthropic/v1/limits.

JSON · условные значения

{
  "object": "list",
  "scope": "provider",
  "refresh_after_seconds": 60,
  "data": [
    {
      "provider_id": "00000000-0000-4000-8000-000000000001",
      "name": "GLM",
      "service": "z.ai_coding",
      "status": "ok",
      "checked_at": "2026-10-12T10:00:00Z",
      "cached": false,
      "limits": [
        {
          "type": "CREDIT_LIMIT",
          "window": "five_hour",
          "unit": "credits",
          "period_unit": 3,
          "period_count": 5,
          "limit": 15000,
          "used": 7500,
          "remaining": 7500,
          "used_percent": 50,
          "resets_at": null
        }
      ]
    }
  ]
}

Как читать ответ

Поле	Значение
`scope: provider`	Квота всего подключения. В неё могут входить запросы других клиентов с тем же ключом.
`status`	Результат чтения конкретного подключения. HTTP 200 не означает, что все квоты доступны.
`checked_at / cached`	Когда шлюз получил результат и взял ли его из кеша. Данные поставщика могут быть старше.
`used_percent`	Процент расхода либо null, если неизвестен. При перерасходе может превышать 100.
`unit`	Единица конкретного окна: credits, tokens, requests, fraction, percent или другая.
`resets_at`	Время сброса в UTC либо null, если неизвестно.

Состояния подключения

status	Что делать
ok	Квота получена, изучите окна и их остаток.
unavailable	Квоту получить не удалось. Прочитайте error.type; при повторяющейся проблеме обратитесь к администратору.
disabled	Подключение отключено. Для возобновления доступа нужен администратор.
unsupported	Чтение квоты этого сервиса не реализовано.

При состоянии, отличном от ok, массив limits пуст. Ошибка одного подключения не скрывает результаты остальных. Исключение: у всего ответа есть общий бюджет 12 секунд; если он истечёт, шлюз вернёт HTTP 504 provider_limits_timeout без data, даже когда часть подключений успела ответить. Без назначений data пуст.

Результаты кешируются до 60 секунд. Следуйте refresh_after_seconds, не опрашивайте API каждую секунду. Для GLM ошибка provider_limits_configuration_required означает, что администратору нужно дополнить настройки подключения.

Ошибки и безопасность

Что можно исправить самому, а когда нужен администратор.