Статистика Аккаунта

GET /stats

Метрики использования API: запросы и траты за сегодня/неделю/всё время (с дельтами к прошлым периодам), успешность за 30 дней, популярные модели, последние задачи (?limit=0..50, по умолчанию 10).

Считается по таблице задач сервиса; баланс — из биллинга AiHere. Все временные окна — UTC (как created_at задач).

Базовый URL: https://api.aihere.ru/api/v1
Авторизация: Authorization: Bearer <API-ключ>
Rate-limit: 30 запросов/мин

Параметры

Поле	Тип	Обяз.	Описание
limit (query)	integer	—	—

Примеры

cURL

curl "https://api.aihere.ru/api/v1/stats" \
  -H "Authorization: Bearer $AIHERE_API_KEY"

Python

import requests

resp = requests.get(
    "https://api.aihere.ru/api/v1/stats",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://api.aihere.ru/api/v1/stats", {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());

PHP

$ch = curl_init('https://api.aihere.ru/api/v1/stats');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($resp);

Ответ 200

Successful Response

{
  "balance": 0.5,
  "requests_today": 1,
  "requests_today_delta_pct": 0.5,
  "requests_week": 1,
  "requests_week_delta_pct": 0.5,
  "spent_today": 0.5,
  "spent_week": 0.5,
  "spent_total": 0.5,
  "success_rate_30d": 0.5,
  "popular_models": [
    {
      "model": "string",
      "count": 1,
      "pct": 0.5
    }
  ],
  "recent_tasks": [
    {
      "task_id": 123,
      "model": "string",
      "status": "waiting",
      "sold_cost": "string",
      "result_url": "https://example.com/image.jpg",
      "created_at": "string"
    }
  ]
}

Ошибки

Код	Причина
422	Ошибка валидации тела запроса (detail содержит список полей)
401	Нет или невалидный API-ключ
429	Превышен rate-limit