Skip to content
Hayonix

API reference · Schema

EndpointAnalytics

  • objectstringrequired

    Always `endpoint_analytics`: the type of this object

    One ofendpoint_analytics

  • endpoint_idstringrequired

    ID of the endpoint

  • startstring (date-time)required

    Start of the period (inclusive)

  • endstring (date-time)required

    End of the period (exclusive)

  • bucketstringrequired

    Width of each `series` bucket (UTC)

    One ofminutehourday

  • totalsobjectrequired

    The whole endpoint over the whole period

    Show 8 fields of totals
    • requestsintegerrequired

      Requests that finished in the period

    • errorsintegerrequired

      Of those, requests that did not complete successfully (errors and aborts)

    • input_tokensstringrequired

      Decimal string

    • output_tokensstringrequired

      Decimal string

    • latency_msobjectrequired

      Total time per request, from when the platform received it until the response finished

      Show 3 fields of latency_ms
      • avginteger | nullrequired

        Mean request latency in milliseconds; null without requests

      • p50integer | nullrequired

        Median (p50) request latency in milliseconds; null without requests

      • p95integer | nullrequired

        95th percentile (p95) request latency in milliseconds; null without requests

    • first_byte_ms_avginteger | nullrequired

      Mean time to the first byte of the response in milliseconds; null without requests

    • replica_secondsstringrequired

      Billed ready replica-seconds (a 2-GPU replica-second counts 2), decimal string

    • replica_coststringrequired

      What those seconds were charged

      pattern ^-?[0-9]+$

  • deploymentsarray of objectrequired

    The same figures per deployment that had requests or replica time

    Show 9 fields of deployments
    • deployment_idstringrequired

      ID of the deployment

    • requestsintegerrequired

      Requests that finished in the period

    • errorsintegerrequired

      Of those, requests that did not complete successfully (errors and aborts)

    • input_tokensstringrequired

      Decimal string

    • output_tokensstringrequired

      Decimal string

    • latency_msobjectrequired

      Total time per request, from when the platform received it until the response finished

      Show 3 fields of latency_ms
      • avginteger | nullrequired

        Mean request latency in milliseconds; null without requests

      • p50integer | nullrequired

        Median (p50) request latency in milliseconds; null without requests

      • p95integer | nullrequired

        95th percentile (p95) request latency in milliseconds; null without requests

    • first_byte_ms_avginteger | nullrequired

      Mean time to the first byte of the response in milliseconds; null without requests

    • replica_secondsstringrequired

      Billed ready replica-seconds (a 2-GPU replica-second counts 2), decimal string

    • replica_coststringrequired

      What those seconds were charged

      pattern ^-?[0-9]+$

  • seriesarray of objectrequired

    Request figures per bucket and deployment in time order; buckets without requests are left out

    Show 8 fields of series
    • bucket_startstring (date-time)required

      Start of the bucket (UTC)

    • deployment_idstring | nullrequired

      ID of the deployment

    • requestsintegerrequired

      Requests that finished in the period

    • errorsintegerrequired

      Of those, requests that did not complete successfully (errors and aborts)

    • input_tokensstringrequired

      Decimal string

    • output_tokensstringrequired

      Decimal string

    • latency_msobjectrequired

      Total time per request, from when the platform received it until the response finished

      Show 3 fields of latency_ms
      • avginteger | nullrequired

        Mean request latency in milliseconds; null without requests

      • p50integer | nullrequired

        Median (p50) request latency in milliseconds; null without requests

      • p95integer | nullrequired

        95th percentile (p95) request latency in milliseconds; null without requests

    • first_byte_ms_avginteger | nullrequired

      Mean time to the first byte of the response in milliseconds; null without requests

Example
{
  "object": "endpoint_analytics",
  "endpoint_id": "string",
  "start": "2026-01-01T00:00:00.000Z",
  "end": "2026-01-01T00:00:00.000Z",
  "bucket": "minute",
  "totals": {
    "requests": 1,
    "errors": 1,
    "input_tokens": "string",
    "output_tokens": "string",
    "latency_ms": {
      "avg": 1,
      "p50": 1,
      "p95": 1
    },
    "first_byte_ms_avg": 1,
    "replica_seconds": "string",
    "replica_cost": "1500000000"
  },
  "deployments": [
    {
      "deployment_id": "string",
      "requests": 1,
      "errors": 1,
      "input_tokens": "string",
      "output_tokens": "string",
      "latency_ms": {
        "avg": 1,
        "p50": 1,
        "p95": 1
      },
      "first_byte_ms_avg": 1,
      "replica_seconds": "string",
      "replica_cost": "1500000000"
    }
  ],
  "series": [
    {
      "bucket_start": "2026-01-01T00:00:00.000Z",
      "deployment_id": "string",
      "requests": 1,
      "errors": 1,
      "input_tokens": "string",
      "output_tokens": "string",
      "latency_ms": {
        "avg": 1,
        "p50": 1,
        "p95": 1
      },
      "first_byte_ms_avg": 1
    }
  ]
}

Used by