- API
API · 静态文件
把图表当数据用。
来自实验室和榜单的 2391 张图、73,917 个数据点,每个都写明数字来源。一次请求,一张图。
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 里。
来源和准确度
实测,而非承诺。在发布方同时以文字写出数字的 16 张真实图表上(都是图上印着数字的分组柱状图),240 个点中有 86.7% 与发布方数字的误差在 3% 以内。在误差超过 3% 的 32 个点里,有 26 个是两遍读取结果相同的印刷数字,很可能是图和文字本身不一致。若如此,97.5% 在 3% 以内。这类点会同时显示两个数字(“图上是 X,模型卡上是 Y”)。
下面的对照测试用已知数据画出我们自己的图。图上印着的数字读得准;从坐标轴读取的值较粗,折线较好,堆叠柱状图和散点图是弱项:堆叠的分段会被读成整数,散点图只有部分点保留了可匹配的标签。我们不为无标签的真实图表提供准确度保证,因为目前还没有真实的标准答案。
| 图表类型 | 图表 | 评分点数 | 1% 内 | 3% 内 | 量程 3% 内 |
|---|---|---|---|---|---|
| 有发布方文字的真实图表(分组柱状图,印着数字) | 16 | 240 | 85.4% | 86.7% | 87.5% |
| 对照测试:柱状图,图上印着数字 | 3 | 24 | 100% | 100% | 100% |
| 对照测试:柱状图,从坐标轴读取 | 3 | 24 | 70.8% | 100% | 100% |
| 对照测试:分组柱状图,图上印着数字 | 2 | 24 | 100% | 100% | 100% |
| 对照测试:分组柱状图,从坐标轴读取 | 3 | 39 | 69.2% | 100% | 100% |
| 对照测试:折线图,从坐标轴读取 | 3 | 52 | 53.8% | 88.5% | 100% |
| 对照测试:堆叠柱状图,从坐标轴读取 | 3 | 50 | 22% | 42% | 86% |
| 对照测试:散点图,带标签的点 | 3 | 18 | 16.7% | 55.6% | 72.2% |
X% 内是相对真实数字。量程 3% 内是相对坐标轴量程。来源:data/chart-data/index.json。
每个档位都遵守:数据永远带有来源和授权说明,估算值永远标明,每张图都保留原文链接。
接口
来自 docs/chart-data.md 中的 OpenAPI 草图。原型里前三个路径是静态文件;过滤和分页需要在线 API。
| 路径 | 上线后积分 | 返回 | |
|---|---|---|---|
| GET | /api/charts/{id}.json | 1 | 一张图:数据点、来源、重绘规格、授权说明。id 未知返回 404,套餐不含返回 402。 |
| GET | /api/charts/{id}.skill.md | 免费 | 一张图的 agent skill 文件(Markdown)。草图里路径写作 /api/charts/{id}/skill.md。 |
| GET | /api/charts/index.json | 1 | 索引:每张图一行。在线形式是 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 -s https://viral-chart.com/api/charts/3c6d3092be5c.json | jq '.points[:2]'curl -s https://viral-chart.com/api/charts/index.json \
| jq '.charts[] | select(.provenance != "estimated-from-image") | .id'curl -s https://viral-chart.com/api/charts/3c6d3092be5c.skill.md一个响应,裁剪为两个数据点。数值来自真实文件: 3c6d3092be5c.
{
"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)、获取路径、字段说明、从授权说明复制的提醒,以及原生图表制作器的重绘步骤。免费。真实文件的开头:
---
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。请注明发布者,并自己绘制图片。