轮询与下载
排队的转换会给你一个任务 ID。这两个端点告诉你何时就绪，并把文件交给你。
查询状态
GET https://rework.live/api/v1/jobs/:id，使用相同的 bearer 令牌。任务等待期间，你还会得到它在队列中的位置和预估时间，以便客户端展示比加载动画更有用的信息。
curl https://rework.live/api/v1/jobs/6a84860000000000000000ab \
-H "Authorization: Bearer rlv_your_key_here"| 状态 | 含义 |
|---|---|
| queued | 等待工作进程。queuePosition 已设置。 |
| running | 正在转换。 |
| done | 已完成。download 可用。 |
| failed | 未能转换。未从你的配额中扣除任何额度。 |
下载结果
GET https://rework.live/api/v1/jobs/:id/download 返回转换后的字节，并带有正确的内容类型和文件名。它在任务过期前一直有效，过期时间由你所用方案的保留窗口决定。
curl -L -o converted.webp \
https://rework.live/api/v1/jobs/6a84860000000000000000ab/download \
-H "Authorization: Bearer rlv_your_key_here"任务归属于密钥
由某个账户创建的任务无法被另一个账户读取。请求他人的任务返回 404 而非 403，这是刻意为之：任务 ID 的可猜测程度足以使「不是你的」与「不存在」之间的区别泄露出他人转换确实存在这一事实。
请以合理的间隔轮询 —— 响应中的预估时间正是用来把握节奏的。紧凑循环式的轮询同样会计入你的每小时限制。