竞赛/平台指南

SAIR API 介绍：用 API 密钥自动化你的竞赛工作流

Introducing SAIR API

竞赛/平台指南🎤 未署名旁白（SAIR / Zindi 官方教程讲解）⏱ 2:57👁 NA

▶ 在 YouTube 观看

一段近3分钟的官方上手教程，演示如何创建 SAIR（基于 Zindi 竞赛平台）API 密钥并完成首次 API 调用，把竞赛工作流接入自己的脚本、训练任务和 CI 流水线。

核心要点

SAIR 公开 API（基于 Zindi 竞赛平台）让你用一把密钥即可自动化竞赛工作：读取竞赛信息、查看排行榜、跟踪提交、运行 playground。
在账户的 API keys 页面创建、查看和吊销密钥；建议为每个任务单独建一把密钥，并只授予该任务所需的最小权限（scopes）。
完整密钥只显示一次，必须立即复制保存，且应放在环境变量、密钥管理器或 CI secrets 中，绝不提交到 GitHub 或公开渠道。
每次请求都要在 authorization 头里携带密钥；先调用 account 端点确认密钥可用及其 scopes，再读竞赛列表并确认所需能力是否可用。
读操作（竞赛信息、排行榜）用 read 端点；写操作（提交、运行 playground、发布到 contributor network）需匹配 scope 的 write 密钥，且要谨慎使用。
写操作有真实代价：playground 运行消耗积分、提交计入限额、发布到 contributor network 的内容是公开的，应坚持最小权限并及时吊销泄露或废弃的密钥。

分章详解

概览：API 能做什么

欢迎来到 Zindi 竞赛公开 API（即 SAIR 公开 API），本视频演示如何创建 API 密钥并完成首次调用。
用一把密钥就能从自己的脚本、训练任务和 CI 流水线中自动化竞赛工作。
可自动化的典型场景：读取竞赛信息、查看排行榜、跟踪自己的提交、运行 playground。

创建 API 密钥

打开账户进入 API keys 页面，这里用于创建、查看和吊销你自己的密钥。
点击 new API key，给它命名，并选择所需的 scopes（权限范围）与过期时间（expiry）。
官方建议为每个任务单独创建一把密钥，且只授予该任务真正需要的 scopes。
确认无误后点击 create key 生成密钥。

妥善保管密钥

完整密钥只会显示这一次，必须当场复制并安全保存。
在项目中应将其存放在环境变量、密钥管理器（secrets manager）或 CI secrets 中。
不要分享密钥，也不要把它提交到 GitHub、公开聊天或共享文档。

用密钥发起 API 调用

每个请求都在 authorization 请求头中携带密钥。
第一步：调用 account 端点，确认密钥可用并查看它携带的 scopes。
第二步：读取竞赛列表或单个竞赛详情，检查它支持哪些能力——排行榜（leaderboard）、playground、contributor network。
在调用某项能力前，先确认该能力对此竞赛可用，再选择对应的端点。

选择读 / 写端点与最小权限原则

第三步：按任务选择端点。读取竞赛信息和排行榜用 read 端点。
提交、运行 playground 或发布则用 write 端点，并配以拥有匹配 scope 的密钥。
谨慎使用写端点：一次 playground 运行会消耗积分（credits），一次提交会计入你的限额，发布到 contributor network 的内容是公开的。
把自动化保持在最小权限（least privilege）密钥上，并吊销任何泄露或不再使用的密钥。

查阅文档与收尾

若不确定某竞赛需要哪些端点，可在 API 文档中打开该竞赛的指南（guide）。
每份指南都列出所支持的端点、请求参数和响应结构。
文档还附带可直接运行的 Python 和 TypeScript 示例。
完成这些步骤后，即可把 SAIR 竞赛工作流接入自己的脚本、训练任务或 CI 流水线，实现读取信息、提交结果等自动化。

关键引述

“用一把密钥，你就能从自己的脚本、训练任务和 CI 流水线中自动化竞赛工作。（With one key, you can automate your competition work from your own scripts, training jobs, and CI pipelines.）”— 旁白

“完整密钥只显示一次，所以现在就复制并妥善保存。（The full key is shown only once, so copy it now and store it somewhere safe.）”— 旁白

“把自动化保持在最小权限密钥上，并吊销任何泄露或你不再使用的密钥。（Keep automation on a least privilege key, and revoke any key that leaks or that you no longer use.）”— 旁白

“我们建议为每个任务单独建一把密钥，只配该任务所需要的 scopes。（We recommend a separate key for each task with only the scopes that task needs.）”— 旁白

术语 / 人物

SAIR（Foundation for Science and AI Research，科学与 AI 研究基金会） — 由 Terence Tao（陶哲轩）等联合创立的机构，旨在用 AI 加速科学发现、并用科学方法研究 AI；通过竞赛、playground 与开放基准把研究流程开放化。

Zindi — 数据科学竞赛平台，SAIR 的竞赛平台与公开 API 基于其技术构建；视频开头即称之为「Zindi 竞赛公开 API」。

API key（API 密钥） — 用于在请求中证明身份的凭据，通过 authorization 头发送；带有特定 scopes 和过期时间，可创建与吊销。

scopes（权限范围） — 密钥被授予的权限集合，决定它能调用读端点还是写端点；建议遵循最小权限原则。

playground — 竞赛中的一项可调用能力，运行一次会消耗积分（credits）。

contributor network（贡献者网络） — 竞赛支持的一项能力，向其发布的内容是公开的。

least privilege（最小权限） — 安全原则：只给密钥/任务最低限度的必要权限，以降低泄露风险。

背景补充

SAIR（Foundation for Science and AI Research，科学与 AI 研究基金会）是 2026 年公开亮相的新机构，由菲尔兹奖得主 Terence Tao（陶哲轩）等多位诺奖、图灵奖、菲尔兹奖学者联合创立，主张「AI for Science」与「Science for AI」并通过竞赛、playground 和开放基准把研究流程开放化。其竞赛平台（competition.sair.foundation）与本视频介绍的公开 API 基于数据科学竞赛平台 Zindi 的技术构建，视频中也直接称其为「Zindi 竞赛公开 API」。

适合谁看

适合打算用代码（脚本、训练任务、CI 流水线）自动化 SAIR/Zindi 竞赛工作的参赛者、数据科学家和工程师，尤其是首次创建并使用 API 密钥、关注密钥安全与权限管理的开发者。