GET/api/orgs/{org_id}/provider/usage/model/{alias}

Get one model's daily health and earnings

Daily uptime, cache hit rate, latency and errors by failure class for one model you serve. uptime counts only dispatched attempts (caller-side refusals do not count against you). 404 when the model is neither one of your lanes nor carries traffic in the window. Same 429 and 503 behavior as the daily usage read.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

    Your organization id (uuid). GET /api/whoami returns it.

  • aliasstring必須

    The model slug (lanes[].model_slug, or alias from the per-model usage read).

クエリパラメータ

  • daysinteger

    Window length in days, counted back from now.

    デフォルト: 30

レスポンス

  • 200

    Daily rows for the model.

    レスポンス
    • aliasstring必須
    • daysinteger必須
    • rowsarray<object>必須
      rows
      • daystring必須
      • request_countinteger必須
      • completed_countinteger必須
      • lane_failure_countinteger必須

        Dispatched attempts that failed on the lane.

      • error_countinteger必須

        Every non-completed event, including caller-side refusals.

      • uptimenumber | null必須

        completed / (completed + lane failures), 0 to 1; null when nothing was dispatched.

      • input_tokensinteger必須
      • output_tokensinteger必須
      • cached_input_tokensinteger必須
      • reasoning_tokensinteger必須
      • cache_hit_ratenumber | null必須

        Cached input tokens over input tokens; null with no input.

      • cost_usdnumber必須

        Settled charged money in US dollars.

      • estimated_cost_usdnumber必須

        List-price value in US dollars.

      • distinct_api_keysinteger必須
      • distinct_orgsinteger必須
      • ttft_p50_msinteger | null必須
      • ttft_p90_msinteger | null必須
      • timeout_countinteger必須
      • errors_by_classobject必須

        Non-completed events counted by failure class.

  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    The model is not one of yours, or the org operates no provider.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<string | integer>
      • msgstring
  • 429

    The usage analytics store is busy; retry after the Retry-After seconds.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 503

    Usage analytics are unavailable on this deployment or temporarily failing.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

リクエスト

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/usage/model/llama-4.1-70b-instruct?days=30 \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "alias": "llama-4.1-70b-instruct",
  "days": 30,
  "rows": [
    {
      "day": "2026-11-18",
      "request_count": 31877,
      "completed_count": 31790,
      "lane_failure_count": 21,
      "error_count": 87,
      "uptime": 0.99934,
      "input_tokens": 120511330,
      "output_tokens": 14002871,
      "cached_input_tokens": 61240511,
      "reasoning_tokens": 0,
      "cache_hit_rate": 0.5082,
      "cost_usd": 54.7811,
      "estimated_cost_usd": 2.9034,
      "distinct_api_keys": 142,
      "distinct_orgs": 61,
      "ttft_p50_ms": 365,
      "ttft_p90_ms": 880,
      "timeout_count": 3,
      "errors_by_class": {
        "provider_error": 18,
        "timeout": 3,
        "quota_exceeded": 52,
        "invalid_request": 14
      }
    }
  ]
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider/usage/model/llama-4.1-70b-instruct?days=30