概览

databurger 开放 API 提供训练数据链路的程序化访问：检索与采购标准数据集、发布视频评判任务、驱动标注作业、查询场景任务库、查看账本与发票。全部接口基于 HTTPS + JSON。

快速开始

复制# 1) 登录取令牌
curl -X POST "https://aidataburger.com/api/v1/login-password" \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800000000","password":"********","role":"buyer"}'

# 返回
{ "token": "3f9a1c..."
, "user": { "id": 1, "phone": "13800000000", "role": "buyer", "balance": 4010.0 } }

# 2) 验证令牌
curl "https://aidataburger.com/api/v1/me" -H "Authorization: Bearer $DB_TOKEN"

认证与鉴权

• 令牌用法：登录后所有请求带 Authorization: Bearer <token>；令牌失效返回 401 {"detail":"未登录或登录过期"}，重新登录即可。
• 登录保护：同一手机号 15 分钟内连续失败 5 次会被临时锁定，期间返回 429。
• 角色权限：发布任务、充值、购买数据集限 buyer；接单、提交作业限 judge；越权返回 403。
• 密钥保管：令牌等同于账号凭证，禁止写入浏览器、移动端或客户端代码。

数据集 API

复制# 检索具身智能数据集
curl "https://aidataburger.com/api/v1/datasets?domain=medical"

# 返回（节选）
[ { "id": 6, "title": "医学影像分割标注集", "domain": "medical",
    "formats": ["json","coco"], "price": 5990.0, "samples": 1500, "status": "on" } ]

# 拉取小样本确认字段
curl "https://aidataburger.com/api/v1/datasets/6/sample"

任务 API 与状态机

视频评判任务的完整生命周期：open（待接单）→ assigned（进行中）→ submitted（待验收）→ done（已验收·已结算）。资金只在最后一步入账。

复制# 需求方发布任务
curl -X POST "https://aidataburger.com/api/v1/tasks" \
  -H "Authorization: Bearer $DB_TOKEN" -H "Content-Type: application/json" \
  -d '{"title":"直播切片合规评判","video_url":"https://.../a.mp4","desc":"...","criteria":["内容合规","画面质量","音频质量","语义连贯","信息价值"]}'

# 返回
{ "ok": true, "task_id": 12, "price_total": 16.0, "judge_payout": 12.0, "platform_margin": 4.0 }

# 产能方提交评分 —— 返回中 settled 恒为 false，此时不入账
curl -X POST "https://aidataburger.com/api/v1/tasks/evaluate" \
  -H "Authorization: Bearer $JUDGE_TOKEN" -H "Content-Type: application/json" \
  -d '{"task_id":12,"scores":{"内容合规":5,"画面质量":4,"音频质量":4,"语义连贯":5,"信息价值":4},"notes":"..."}'

# 返回（节选）
{ "ok": true, "status": "submitted", "status_label": "待验收", "settled": false,
  "note": "已提交，等待需求方验收；验收通过后才会结算入账" }

# 需求方验收通过 —— 此时才结算
curl -X POST "https://aidataburger.com/api/v1/tasks/12/accept" -H "Authorization: Bearer $DB_TOKEN"
# 返回：{"ok":true,"status":"done","status_label":"已验收·已结算","settled":true,"payout":12.0}

标注任务 API

type 取值：video_judge（视频评判）、trajectory（轨迹标注）、pcd_6dof（点云 6DoF 标注）。

场景任务库 API

实体操作 SOP 场景库，公开可读，用于按需选题与定制采集。

复制curl "https://aidataburger.com/api/v1/scenario-tasks?l1=%E4%B8%AA%E4%BA%BA%E6%8A%A4%E7%90%86%E4%B8%8E%E5%81%A5%E5%BA%B7&limit=2"

# 返回
{ "total": 6300, "limit": 2, "offset": 0, "items": [
  { "id": 1, "l1": "个人护理与健康", "l2": "健身器械维保",
    "title": "张紧跑步机传动皮带", "sop": "先断开跑步机电源开关...", "status": "open" } ] }

账号与资金 API

平台公开数据

官网首页「实时平台数据」即调用该接口，无需鉴权，可直接接入你的看板。

复制curl "https://aidataburger.com/api/v1/metrics/public"

# 返回
{ "online": 101, "today": 0, "review": 18.5, "pass": 92.0,
  "cities": 12, "batches": 4, "updated_at": "2026-10-02T14:41:16.343607" }

投诉与举报

受理号由服务端生成并落库后才返回，前端不得自行构造。

个人信息权利受理

对应《隐私政策》第六章的法定权利渠道，无需登录即可提交。受理号由服务端生成并落库后返回。

复制curl -X POST "https://aidataburger.com/api/v1/privacy-requests" \
  -H "Content-Type: application/json" \
  -d '{"kind":"删除","identity":"13800000000","detail":"申请删除我的账号及个人信息","contact":"13800000000","agreed":true}'

# 返回
{ "ok": true, "ticket": "PR20261002-B4X9", "request_id": 1 }

错误码

调用约定

• 限流：业务接口当前未设置 QPS 限流；仅登录接口有失败次数保护（15 分钟 5 次）。
• 计费口径：只读接口不计费；发布任务按任务款计费，购买数据集按标价计费。
• 超时与重试：建议连接超时 5 秒、读超时 30 秒；仅对 5xx 与网络错误做指数退避重试，4xx 不要重试。
• 幂等：任务发布、购买、充值均为即时扣款的写操作，请勿在超时后盲目重放；先查 /ledger 确认是否已发生。

Webhook

SDK 与示例

Python（标准库 urllib，无需安装依赖）

复制import json, urllib.request

BASE = "https://aidataburger.com/api/v1"

def call(method, path, token=None, body=None):
    data = json.dumps(body).encode() if body else None
    req = urllib.request.Request(BASE + path, data=data, method=method)
    req.add_header("Content-Type", "application/json")
    if token:
        req.add_header("Authorization", "Bearer " + token)
    with urllib.request.urlopen(req, timeout=30) as r:
        return json.loads(r.read().decode())

# 登录
resp = call("POST", "/login-password", body={
    "phone": "13800000000", "password": "********", "role": "buyer"})
token = resp["token"]

# 检索数据集
for ds in call("GET", "/datasets?domain=medical"):
    print(ds["id"], ds["title"], ds["samples"], ds["price"])

# 发布任务并查看状态
t = call("POST", "/tasks", token, {
    "title": "直播切片合规评判", "video_url": "https://.../a.mp4"})
print(t["task_id"], t["price_total"], t["judge_payout"])

JavaScript（浏览器 / Node 18+ 原生 fetch）

复制const BASE = "https://aidataburger.com/api/v1";

async function call(path, { method = "GET", token, body } = {}) {
  const r = await fetch(BASE + path, {
    method,
    headers: {
      "Content-Type": "application/json",
      ...(token ? { Authorization: `Bearer ${token}` } : {}),
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!r.ok) throw new Error(`${r.status} ` + await r.text());
  return r.json();
}

// 公开接口无需鉴权
const metrics = await call("/metrics/public");
console.log(metrics.online, metrics.pass_rate ?? metrics.pass);

const { token } = await call("/login-password", {
  method: "POST",
  body: { phone: "13800000000", password: "********", role: "buyer" },
});
const me = await call("/me", { token });

接入教程

场景一：把标准数据集接入训练流水线

1. GET /datasets?domain=... 检索候选数据集，按 samples / price 初筛
2. GET /datasets/{did}/sample 拉取小样本，跑一次基线训练确认字段可用
3. GET /datasets/{did}/report 查看质检报告摘要
4. 确认后 POST /datasets/{did}/buy 下单，随后用 GET /datasets/mine 查看已购

场景二：批量视频评判并核对结算

1. POST /recharge 保证钱包余额，再 POST /tasks 批量发布
2. 产能方 GET /tasks/open → POST /tasks/{tid}/claim → POST /tasks/evaluate
3. 需求方 GET /tasks/mine 查看 submitted 任务；不满意走 POST /tasks/{tid}/reject 带原因返工
4. 满意后 POST /tasks/{tid}/accept，此时才结算；用 GET /ledger 核对收支流水

场景三：把平台公开数据接入你的 BI

1. GET /metrics/public 无需鉴权，按日轮询写入数仓
2. 账号维度数据用 GET /ledger 与 GET /projects（需令牌）

变更日志