Usage history — GET /v1/payments/usage

The usage endpoint returns your inference usage history as an array of per-request records. Each record shows the model used, the token counts, the cost charged, and the timestamp of the request. This data is useful for auditing your spending, tracking usage patterns by model, and reconciling costs.

Authentication

This endpoint requires a Bearer token:

Authorization: Bearer eigeninference-...

Response

object[]

Array of usage entries, most recent first.

Show entry fields

string

The internal job UUID for this inference request. Matches the X-Inference-Job-ID header returned on streaming responses.

string

The model ID used for this request.

integer

Number of input tokens consumed.

integer

Number of output tokens generated.

integer

The cost charged for this request in micro-USD.

string

ISO 8601 timestamp of when the request was completed.

Example

cURL

curl https://api.darkbloom.dev/v1/payments/usage \
  -H "Authorization: Bearer eigeninference-..."

Example response

{
  "usage": [
    {
      "request_id": "a3f1c2e7-84bb-4d9a-91f3-2b7e6d4a0c18",
      "model": "qwen3.5-27b-claude-opus-8bit",
      "prompt_tokens": 14,
      "completion_tokens": 87,
      "cost_micro_usd": 72,
      "timestamp": "2025-04-30T14:22:07Z"
    },
    {
      "request_id": "b7d3e9f1-21cc-4a8b-85e2-9c4d1a7f3b22",
      "model": "mlx-community/gemma-4-26b-a4b-it-8bit",
      "prompt_tokens": 32,
      "completion_tokens": 210,
      "cost_micro_usd": 44,
      "timestamp": "2025-04-30T13:05:41Z"
    }
  ]
}

Inference

Account

Network

Usage history — GET /v1/payments/usage

Authentication

Response

Example

Example response

​Authentication

​Response

​Example

​Example response

Authentication

Response

Example

Example response