{"info":{"description":"只读的指标数据与历史数据公开接口。所有端点均为 GET，只返回数据，不提供任何写操作或服务功能调用。所有响应不包含任何 API Key / 密钥信息。","license":{"name":"MIT"},"title":"aiping-server Public Metrics API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/api/bench":{"get":{"operationId":"getBench","responses":{"200":{"content":{"application/json":{"example":[{"completion_tokens":null,"error":null,"first_ms":520,"model":"deepseek-v4-flash","name":"DeepSeek","prompt_tokens":null,"provider_id":"deepseek","region":"中国","status":"ok","total_ms":3400,"ts":1723000000}]}},"description":"测速结果数组（按总耗时升序）"}},"summary":"各模型最新一次测速结果"}},"/api/bench/history":{"get":{"operationId":"getBenchHistory","parameters":[{"description":"按供应商 id 过滤；省略返回全部（key 为 provider::model）","in":"query","name":"provider","required":false,"schema":{"type":"string"}},{"description":"最近 N 小时（默认 24）；hours=0 返回全部历史。当 start_ts/end_ts 给出时此参数被忽略","in":"query","name":"hours","required":false,"schema":{"default":24,"type":"integer"}},{"description":"起始时间（Unix 秒，含）","in":"query","name":"start_ts","required":false,"schema":{"type":"integer"}},{"description":"结束时间（Unix 秒，含）","in":"query","name":"end_ts","required":false,"schema":{"type":"integer"}},{"description":"单个 series 返回数据点上限；0 或不传不限制","in":"query","name":"limit","required":false,"schema":{"default":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"api_version":"v1","series":{"deepseek::deepseek-v4-flash":[{"first_ms":520,"total_ms":3400,"ts":1723000000}]},"updated_at":1723000000}}},"description":"测速历史"}},"summary":"测速历史序列"}},"/api/docs":{"get":{"operationId":"getDocs","responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"HTML 文档页面"}},"summary":"HTML API 文档"}},"/api/health":{"get":{"operationId":"health","responses":{"200":{"content":{"application/json":{"example":{"api_version":"v1","status":"ok","updated_at":1723000000}}},"description":"服务存活"}},"summary":"服务健康检查"}},"/api/history":{"get":{"operationId":"getHistory","responses":{"200":{"content":{"application/json":{"example":{"deepseek":{"samples":[{"latency":320,"status":"online","ts":1723000000}],"uptime":99.5}}}},"description":"按供应商 id 索引的历史"}},"summary":"供应商在线历史（uptime 与采样点）"}},"/api/market":{"get":{"operationId":"getMarket","responses":{"200":{"content":{"application/json":{"example":{"api_version":"v1","days":[],"geo":[],"geo_date":"","geo_history":[],"leader":[],"leader_cum":[],"leader_date":"","leader_history":[],"ranking":[],"updated_at":1723000000}}},"description":"市场数据（含 updated_at 与 api_version）"}},"summary":"市场用量排行、Geo 分布与模型 Leaderboard"}},"/api/openapi.json":{"get":{"operationId":"getOpenapi","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"OpenAPI JSON"}},"summary":"OpenAPI 3.0 描述（本文件）"}},"/api/status":{"get":{"operationId":"getStatus","responses":{"200":{"content":{"application/json":{"example":[{"api_url":"https://api.deepseek.com","category":"模型商","error":null,"id":"deepseek","latency":320,"models":["deepseek-v4-flash","deepseek-v4-pro"],"name":"DeepSeek","region":"中国","status":"online","ts":1723000000,"updated_at":"2026-08-05 10:00:00"}]}},"description":"供应商状态数组"}},"summary":"各供应商在线状态与延迟探测"}},"/api/superclue":{"get":{"operationId":"getSuperclue","responses":{"200":{"content":{"application/json":{"example":{"models":[]}}},"description":"SuperCLUE 数据"}},"summary":"SuperCLUE 模型能力榜单（静态快照）"}}},"servers":[{"description":"Same origin as the service","url":"/"}]}