开放 API把服务端工具接到你自己的系统里

一、鉴权

每个请求都带上密钥：

Authorization: Bearer tdd_xxxxxxxxxxxxxxxx

密钥只发给登录用户（游客拿不到，否则等于给匿名流量开一条绕过页面限流的路）。明文只在创建那一屏出现一次，服务端只存 sha256——忘了只能重新生成。

二、调用流程

1. 建任务：POST /api/v1/tasks，multipart 表单字段 tool（工具代号）、file（多文件用 files[]）、params（JSON 字符串）
2. 查状态：GET /api/v1/tasks?no=任务号，status 为 done 时返回 result.url
3. 下结果：GET /api/v1/results?no=任务号，同样带 Bearer 头
4. 看用量：GET /api/v1/usage，返回今日额度与本分钟已用次数

示例（HEIC 转 JPG）：

curl -X POST https://www.tdd8.cn/api/v1/tasks \
  -H "Authorization: Bearer tdd_xxx" \
  -F "tool=convert_heic" \
  -F "params={\"format\":\"jpg\"}" \
  -F "file=@photo.heic"

# 返回 {"ok":true,"task_no":"T2026...","status":"pending","left":19,"ttl":7200}

curl -H "Authorization: Bearer tdd_xxx" \
  "https://www.tdd8.cn/api/v1/tasks?no=T2026..."        # 查状态
curl -H "Authorization: Bearer tdd_xxx" -o out.jpg \
  "https://www.tdd8.cn/api/v1/results?no=T2026..."      # 下载

工具代号就是各工具页的 code，例如 convert_heic、pdf_to_jpg、 video_convert、gif_reverse、denoise。 只有在浏览器里跑不动、必须服务端处理的工具才开放 API，传本地工具代号会返回 404。

三、额度与限流

• 额度：和网页共用同一份——免费用户 20 次/天，会员按套餐（200 起），每天 0 点重置。一个文件算一次。
• 限流：每个密钥每分钟最多建 你创建时选的那个值 个任务，超限返回 429 并带 Retry-After: 60。
• 并发：同一密钥最多 3 个任务在排队或处理中，超了返回 429。
• 结果保留：跟随账号——免费 2 小时，会员 24 小时 / 72 小时 / 7 天，过期文件被清理，接口返回 410。
• 计费：目前不单独收费，API 与网页共用额度；后续若推出按调用量计费的套餐，会另行公告，不会默默改规则。

四、错误码

五、我的密钥

密钥只对登录用户开放。登录后可以在这一页直接创建，没有账号就 注册一个。

常见问题