Skip to main content

GPU Performance API

GET /api/silicon-mark/v1/gpus

List individual GPUs with scoreboard performance tiers. Returns paginated individual-GPU benchmark rows with server-derived Gaussian percentile tiers. In v1, scoreboard metrics are populated only when benchmark_id is quick_mark.

Authorization

🔒OAuth2: OAuth2PasswordBearer
Flow type: password
Token URL: token

Query Parameters

FieldTypeRequiredDescriptionConstraints
pageintegerNoPage number>= 1, default 1
per_pageintegerNoItems per page[ 1 .. 300 ], default 20
benchmark_idstringNoBenchmark that drives scoreboard rowsdefault quick_mark (v1: use quick_mark)
gpu_modelstringNoFilter by GPU model
statusstringNoFilter by Gaussian percentile tieroptimal, acceptable, underperforming
namestringNoSubstring filter on job name
tagsarrayNoFilter by job tags (repeat for multiple; job must include all)
statestringNoJob state filterdefault completed when omitted

Responses

  • 200: Successful Response
{
  "results": [
    {
      "id": "7554621441-0",
      "gpu_label": "GPU0",
      "gpu_id": "GPU-550e8400-e29b-41d4-a716-446655440000",
      "model": "NVIDIA A100-SXM4-80GB",
      "job_name": "GPU Benchmark Test",
      "node_name": "192.168.1.10",
      "fp16": 78.5,
      "fp32": 39.2,
      "memory_bandwidth": 1935.4,
      "percentile": 82.4,
      "status": "optimal"
    }
  ],
  "pagination": {
    "total": 32,
    "page": 1,
    "per_page": 20,
    "total_pages": 2,
    "has_next": true,
    "has_prev": false
  }
}