1. API

API · 静态文件

把图表当数据用。

来自实验室和榜单的 2391 张图、73,917 个数据点,每个都写明数字来源。一次请求,一张图。

curl上线后 1 积分
curl -s https://viral-chart.com/api/charts/3c6d3092be5c.json

这些是原型的静态文件,不是在线 API。目前不需要密钥,也不扣费。网站上线前,请使用你正在阅读本页的这个主机。

数据是什么

实验室或榜单发布的每张图对应一个 JSON 文件:标题、发布方、原文链接、每个点(分组、系列、数值、单位)、数字是否印在图上、获取方式(provenance)、0 到 1 的置信度,以及原生图表的重绘规格和授权说明。provenance 取值为 publisher-text、mixed 或 estimated-from-image。我们不从榜单抓数字,来源链接是供你核对的。

每个文件还带有 style 字段:描述原图长相的样式规格(图型、画布和配色、字体、图例、坐标轴、系列颜色和纹理、高亮、数值标签、logo 标记)。我们的渲染器用数据点加这份规格画出相似重绘。评审得分达到 7 分(满分 10)才算通过:目前 2391 张图里有 95 张通过,每个文件都有 replica.score 和 replica.accepted。评审认为名称或数字是主要问题时,第二次读取的结果在 replicaData 里。

2391张图
73,917个数据点
2 / 29 / 2360publisher-text / mixed / estimated
12家实验室

来源和准确度

实测,而非承诺。在发布方同时以文字写出数字的 16 张真实图表上(都是图上印着数字的分组柱状图),240 个点中有 86.7% 与发布方数字的误差在 3% 以内。在误差超过 3% 的 32 个点里,有 26 个是两遍读取结果相同的印刷数字,很可能是图和文字本身不一致。若如此,97.5% 在 3% 以内。这类点会同时显示两个数字(“图上是 X,模型卡上是 Y”)。

下面的对照测试用已知数据画出我们自己的图。图上印着的数字读得准;从坐标轴读取的值较粗,折线较好,堆叠柱状图和散点图是弱项:堆叠的分段会被读成整数,散点图只有部分点保留了可匹配的标签。我们不为无标签的真实图表提供准确度保证,因为目前还没有真实的标准答案。

图表类型图表评分点数1% 内3% 内量程 3% 内
有发布方文字的真实图表(分组柱状图,印着数字)1624085.4%86.7%87.5%
对照测试:柱状图,图上印着数字324100%100%100%
对照测试:柱状图,从坐标轴读取32470.8%100%100%
对照测试:分组柱状图,图上印着数字224100%100%100%
对照测试:分组柱状图,从坐标轴读取33969.2%100%100%
对照测试:折线图,从坐标轴读取35253.8%88.5%100%
对照测试:堆叠柱状图,从坐标轴读取35022%42%86%
对照测试:散点图,带标签的点31816.7%55.6%72.2%

X% 内是相对真实数字。量程 3% 内是相对坐标轴量程。来源:data/chart-data/index.json。

每个档位都遵守:数据永远带有来源和授权说明,估算值永远标明,每张图都保留原文链接。

接口

来自 docs/chart-data.md 中的 OpenAPI 草图。原型里前三个路径是静态文件;过滤和分页需要在线 API。

路径上线后积分返回
GET/api/charts/{id}.json1一张图:数据点、来源、重绘规格、授权说明。id 未知返回 404,套餐不含返回 402。
GET/api/charts/{id}.skill.md免费一张图的 agent skill 文件(Markdown)。草图里路径写作 /api/charts/{id}/skill.md。
GET/api/charts/index.json1索引:每张图一行。在线形式是 GET /api/charts。
GET/api/charts?model=&publisher=&form=&provenance=&limit=&cursor=每 25 行 1 个(建议)仅在线 API。过滤项:model、publisher、form(bar、grouped-bar、benchmark-bars、line、scatter、stacked-bar、table)、provenance(publisher-text、mixed、estimated-from-image)。limit 最多 200,cursor 取下一页。

建议的档位:免费版可看前几行和 publisher-text 图表,Pro 用于策展(收藏、看板、提醒、完整历史、所有图表不再模糊),Max 用于拆解(每张图的数据 JSON、样式规格、重绘制作器、API 和批量导出)。目前网站不对此收费。文件中不含内部字段(selectionReason、nearMissTruth)。

示例

针对静态文件。网站上线前,请把主机换成你正在使用的主机。

curl上线后 1 积分
curl -s https://viral-chart.com/api/charts/3c6d3092be5c.json | jq '.points[:2]'
curl上线后 1 积分
curl -s https://viral-chart.com/api/charts/index.json \
  | jq '.charts[] | select(.provenance != "estimated-from-image") | .id'
curl免费
curl -s https://viral-chart.com/api/charts/3c6d3092be5c.skill.md

一个响应,裁剪为两个数据点。数值来自真实文件: 3c6d3092be5c.

JSON
{
  "id": "3c6d3092be5c",
  "title": "LLM Performance Evaluation",
  "publisher": "Z.ai",
  "url": "https://huggingface.co/zai-org/GLM-5.3",
  "sourceUrl": "https://www.tbench.ai/leaderboard",
  "provenance": "publisher-text",
  "confidence": 1,
  "chart": {
    "type": "grouped-bar",
    "series": [
      "GLM-5.3",
      "GLM-5.2",
      "Kimi K3"
    ]
  },
  "points": [
    {
      "group": "Terminal Bench 3.0",
      "series": "GLM-5.3",
      "value": 28.3,
      "provenance": "publisher-text",
      "confidence": 1,
      "printed": true
    },
    {
      "group": "Terminal Bench 3.0",
      "series": "GLM-5.2",
      "value": 4.6,
      "provenance": "publisher-text",
      "confidence": 1,
      "printed": true
    }
  ],
  "license_note": "These numbers describe a chart published by Z.ai. The image and design belong to them. Values marked estimated-from-image may be off. Original: https://huggingface.co/zai-org/GLM-5.3"
}

skill 文件

每张图一个 Markdown 文件,给 agent 用。包含 front matter(name、description)、获取路径、字段说明、从授权说明复制的提醒,以及原生图表制作器的重绘步骤。免费。真实文件的开头:

markdown
---
name: chart-data-3c6d3092be5c
description: Data points of the chart "LLM Performance Evaluation" published by Z.ai (publisher-text, 30 points). Use it to study the numbers or to redraw a similar chart under your own brand with the CountStory native chart maker.
---

# LLM Performance Evaluation

Publisher: Z.ai. Subject: GLM-5 (zai). Original: https://huggingface.co/zai-org/GLM-5.3

## Fetch

- Local file: `data/chart-data/3c6d3092be5c.json`
- API form: `GET /api/charts/3c6d3092be5c.json` (see docs/chart-data.md for the OpenAPI sketch)

## Fields

每次调用的积分

付费开通后的价目表。目前这些文件不收费。美元按最小充值包计算,详见 价格页.

动作积分折合美元
一张图的 JSON 或 CSV(下载或 API 调用)1$0.005
一页 25 行的列表(API)1$0.005
模型全家桶:一个模型的全部图表,最多 100 张10$0.05
重绘工具包:图表 JSON、skill 文件和 SVG 起稿3$0.015
从图片中提取数据点(估算值,并明确标注)40$0.20
浏览、页面、每日图表、每周简报、skill 文件、llms.txt、失败或为空的调用免费$0

付费开通后领取密钥

还没开通付费。留下邮箱,开通当天我们给你发邮件。

原型:只保存在本设备。

常见问题

这是在线 API 吗?

不是。原型里这些文件是静态的,不需要密钥。路径和结构与未来在线 API 保持一致,付费尚未开通。

数据有多准?

在发布方同时以文字写出数字的 16 张真实图表上,240 个点中有 86.7% 误差在 3% 以内。堆叠柱状图和散点图较弱。见上表。

数字可以商用吗?

这些数字描述的是图表所有者发布的图。每个文件都带有 license_note。请注明发布者,并自己绘制图片。