BazaarLinkBazaarLink
Đăng nhập
Tài liệuTham chiếu APITham chiếu SDKSử dụng AgentKỹ năng AI
Tài khoản

Lấy thông tin chi tiết sử dụng

Trả về mọi thứ mà trang /insights cần trong một lần gọi: chuỗi xu hướng cho cả 3 chỉ số (token/chi tiêu/số yêu cầu), top 3 model theo từng chỉ số, thống kê hit cache prompt, phân tích token, bản đồ nhiệt theo năm (kèm streak), sử dụng credit/model miễn phí, và tùy chọn bảng lọc. Được cache 5 phút theo tổ hợp (người dùng, period, heatmap_metric, bộ lọc).

GET/api/v1/insights

Xác thực

Authorizationbắt buộc
string · header

API key dưới dạng bearer token trong header Authorization.

Tham số truy vấn

period
string

Chi phối khung thời gian của toàn trang, mặc định 7d. Giá trị không nhận diện được trả về 400.

7d30dytdall
Example: "30d"
heatmap_metric
string

Chỉ số mà bản đồ nhiệt theo năm hiển thị (bản đồ nhiệt luôn là cả năm dương lịch, không phụ thuộc period), mặc định spend. Giá trị không nhận diện được trả về 400.

spendtokensrequests
Example: "tokens"
model
string

Bộ lọc toàn trang — chỉ tính sử dụng cho model này. Bỏ qua nghĩa là không lọc.

api_key_id
string

Bộ lọc toàn trang — chỉ tính sử dụng cho API key này. Bỏ qua nghĩa là không lọc.

app
string

Bộ lọc toàn trang — chỉ tính sử dụng được gắn thẻ tên ứng dụng này (x-title / HTTP-Referer). Bỏ qua nghĩa là không lọc.

GET /api/v1/insights
curl "https://bazaarlink.ai/api/v1/insights?period=30d&heatmap_metric=tokens" \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"
Ví dụ phản hồi

Thành công. trend/topModels/heatmap luôn trả về đầy đủ dữ liệu cho cả 3 chỉ số (tokens, spend, requests) nên việc chuyển đổi ở frontend không cần gọi lại; caching và breakdown được chia bucket theo period (hàng ngày ≤120 ngày, hàng tuần ≤730 ngày, còn lại theo tháng). Ví dụ dưới đây đã rút gọn — mảng buckets/heatmap.days thực tế chứa nhiều mục tùy độ dài period.

{
  "period": "30d",
  "bucketUnit": "day",
  "trend": {
    "tokens": {
      "total": 152000,
      "prevTotal": 98000,
      "changePct": 55.1,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 5200
            }
          ]
        }
      ]
    },
    "spend": {
      "total": 4.82,
      "prevTotal": 3.1,
      "changePct": 55.5,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 0.16
            }
          ]
        }
      ]
    },
    "requests": {
      "total": 340,
      "prevTotal": 210,
      "changePct": 61.9,
      "buckets": [
        {
          "date": "2026-07-01",
          "segs": [
            {
              "model": "openai/gpt-4.1",
              "value": 12
            }
          ]
        }
      ]
    }
  },
  "topModels": {
    "tokens": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 152000,
        "unit": "tokens"
      }
    ],
    "spend": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 4.82,
        "unit": "spend"
      }
    ],
    "requests": [
      {
        "model": "openai/gpt-4.1",
        "provider": "openai",
        "value": 340,
        "unit": "requests"
      }
    ]
  },
  "caching": {
    "buckets": [
      {
        "date": "2026-07-01",
        "hit": 3200,
        "write": 800
      }
    ],
    "totalHit": 96000,
    "totalWrite": 24000
  },
  "breakdown": {
    "buckets": [
      {
        "date": "2026-07-01",
        "prompt": 4000,
        "completion": 1200,
        "reasoning": 0,
        "cached": 3200
      }
    ],
    "totals": {
      "prompt": 120000,
      "completion": 32000,
      "reasoning": 0,
      "cached": 96000
    }
  },
  "heatmap": {
    "spend": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 0.02
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 0.16,
      "avgWeek": 1.12,
      "total": 58.4
    },
    "tokens": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 640
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 5066,
      "avgWeek": 35462,
      "total": 1850000
    },
    "requests": {
      "days": [
        {
          "date": "2026-01-01",
          "value": 4
        }
      ],
      "streak": {
        "current": 5,
        "longest": 21
      },
      "avgDay": 11.3,
      "avgWeek": 79,
      "total": 4130
    }
  },
  "credit": {
    "today": 0.16,
    "thisWeek": 1.12,
    "thisMonth": 4.82
  },
  "freeModel": {
    "today": 0,
    "thisWeek": 0,
    "thisMonth": 0
  },
  "facets": {
    "models": [
      "openai/gpt-4.1"
    ],
    "apiKeys": [
      {
        "id": "key_abc123",
        "name": "default"
      }
    ],
    "apps": [
      "my-app"
    ]
  }
}
Support
Support
Hi! How can we help you?
Send a message and we'll get back to you soon.
Lấy thông tin chi tiết sử dụng — BazaarLink API