Mager API
Account

Ambil pemakaian API

GET/api/v1/usage

Jumlah permintaan, mood yang ditagihkan, dan waktu response untuk akun ini, dirinci per endpoint dan per hari. Hanya panggilan yang menagih yang punya biaya, jadi polling sebuah task tidak pernah muncul sebagai pengeluaran tambahan.

Autentikasi

MagerApiKey
x-mager-api-key<token>

API key Mager

Di: header

Parameter query

from?string

Awal rentang waktu dalam format ISO. Bawaannya 30 hari lalu.

to?string

Akhir rentang waktu dalam format ISO. Bawaannya saat ini.

Parameter header

x-mager-api-key*string

API key Mager

Body response

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/usage" \  -H "x-mager-api-key: YOUR_API_KEY"
{  "status": 200,  "message": "Success",  "data": {    "range": {      "from": "2026-07-04T00:00:00.000Z",      "to": "2026-08-03T00:00:00.000Z"    },    "totals": {      "requests": 1284,      "base_moods": 3120,      "charged_moods": 4680,      "avg_response_time_ms": 842    },    "by_endpoint": [      {        "endpoint": "/api/v1/generation-tasks",        "method": "POST",        "requests": 412,        "charged_moods": 4680,        "avg_response_time_ms": 2310      },      {        "endpoint": "/api/v1/generation-tasks/:taskId",        "method": "GET",        "requests": 831,        "charged_moods": 0,        "avg_response_time_ms": 96      }    ],    "by_day": [      {        "day": "2026-08-01",        "requests": 143,        "charged_moods": 520      },      {        "day": "2026-08-02",        "requests": 168,        "charged_moods": 615      }    ]  }}