← 返回标注平台下载 OpenAPI 规范 ↗

RUBRIC / 开发者文档

用 API 读取和管理样本

把样本、标注和复核结果接入你的工具。下面的接口与当前服务一致。

数据范围

当前是 Console 的 6 条历史样本快照(3 张图片、3 个视频),不是全部任务,也不是实时同步。训练候选仅包含已由不同账号复核通过的标注。

开始之前

先通过平台使用 Emorika 登录,并取得 Rubric 访问权限。接口使用登录会话 Cookie;没有 API Key 或服务间专用认证。跨域调用尚未开放。不要把 Cookie 放进代码仓库或分享给他人。

写入接口必须携带与请求 Host 匹配的 Origin,请求体是 JSON,最大 6,000,000 字节。标注人和复核人由服务端根据登录账号确定。

在已登录的同源页面读取

const response = await fetch('/api/v1/training/samples?label=positive', {
  credentials: 'same-origin'
});
const data = await response.json();
console.log(data.samples);

也可下载 OpenAPI JSON,导入支持 OpenAPI 的工具。会话过期时需重新登录。

先检查登录,再读取业务数据

读取 /api/v1/session。只有 authenticated: true 才代表当前请求已通过认证。页面右上角“账号”和接口页“鉴权与调用 · Auth”可以查看当前身份,并检测真实会话。

外部脚本可以使用已有的合法 Cookie 文件,但会话会过期。当前没有 API Key、Bearer Token 签发或服务账号登录接口,长期服务调用还需要接入专用凭证。健康检查返回成功,不代表业务接口已经授权。

接口一览

GET /api/v1/member-operations?subject=账号ID&offset=0

仅管理员可查看指定成员的操作记录,每页 50 条。包含标注、复核、权限变更、规则发布和新记录的草稿保存;早期草稿与浏览操作没有完整记录。

GET /api/v1/rubric

返回 current 当前规则、versions 历史版本和 draft 共享草稿。成员可查看,只有管理员可修改和发布。

POST /api/v1/rubric/draft

管理员保存规则草稿。传 base_version 当前版本和 criteria 完整维度列表(1 至 20 个);每个维度包含 id、title、pass、fail、scope。scope 为 all、image、video 或 reference。支持增加、删除和修改;至少保留图片与视频各一个适用维度。新维度使用新 ID。

GET /api/v1/members

仅管理员读取已登录成员、角色和权限审计。loopwangzi 是固定管理员。新成员需先通过统一登录的 Rubric 授权,再默认以只读角色加入。

POST /api/v1/members/role

仅管理员修改成员角色。传 subject、role、previous_role。支持 admin、contributor、annotator、reviewer、viewer、disabled;旧角色不匹配返回 409。变更在下一次请求生效,不能移除固定管理员。此授权不能绕过统一登录的 Rubric 权限。

POST /api/v1/rubric/publish

参数同草稿。发布后生成不可变新版本,只影响新标注。旧记录不会重新评分;旧标注详情的 rubric_snapshot 和导出的 rubric 保留当时规则。版本过期返回 409。

提交标注时传 rubric_version,必须匹配当前版本。旧客户端省略时按 2.1 处理。机器预检 score 是通过项 ÷ 已核实项 × 100;score_basis 列出 passed、known、unknown。未知项不计入,这不是内容质量分。

GET /api/v1/health

检查服务状态。公开;返回版本和样本数量。

GET /api/v1/session

查看当前是否登录、账号信息和登录地址。公开;未登录时 actor 为 null。

GET /api/v1/samples

读取样本列表、当前标注和评分规则。列表不含完整输入、模型提示词、翻译和性能数据;请使用详情接口。当前没有分页或筛选。

GET /api/v1/samples/{task_id}

读取单条样本的完整输入、输出、参考素材、性能、来源及最新标注。还返回 precheck 技术预检,包含文件可读性、图片尺寸与字段来源;不代表 AI 内容判断。任务不存在返回 404。

GET /api/v1/training/samples

读取已复核通过的训练候选,包含完整任务和标注。可用 ?label=positive 或 ?label=negative 筛选;没有分页。返回的 training_executed: false 表示尚未执行训练。

GET /api/v1/monitor

查看当前服务检查和后台监控状态。

POST /api/v1/evidence

上传标注截图。JSON 中 data 是 PNG、JPEG 或 WebP 的 data URL,name 可选。原图解码后最多 3 MB、1600 万像素;保存为 PNG。每账号最多 40 张、25 MB。

GET /api/v1/evidence/{evidence_id}

读取截图 PNG。未提交的截图仅上传者可见;提交后,有权限的工作空间用户可以读取。不存在或无权读取均返回 404。

POST /api/v1/samples/{task_id}/annotation

提交标注。label 为 positive、negative、uncertain 或 excluded;可提交说明、各维度判断及最多 4 张截图。previous_id 必须与最新标注 ID 一致,首次提交可省略或设为 null,避免覆盖他人的修改。

正例要求任务完成、有输出、确认并通过所有适用维度;负例至少一个维度失败,需提供理由或关联截图。视频失败维度还需要有效的起止秒数。待确认或排除需要理由或截图。

POST /api/v1/annotations/{annotation_id}/review

复核已提交标注。action 为 approve(通过)或 return(退回);退回时必须填写 reason。标注者不能复核自己的标注。

错误怎么处理

错误一般返回 {"error":"原因"}。400:参数不符合规则;401:未登录;403:无权限、来源不匹配或自己复核自己;404:资源不存在或不可见;409:数据已变化或状态冲突;413:内容太大;503:认证服务不可用。

接口字段与数据结构详见 OpenAPI 规范。文档公开,样本和标注仍需授权。