转换一个文件

一个端点完成全部工作。提交一个文件和一个目标格式，得到一个任务 —— 如果够快就是已完成，否则就是排队中。

认证

除格式目录之外的所有端点都需要 API 密钥，以 bearer 令牌形式发送。在账户的「自动化」页面创建一个；它只显示一次，且仅以哈希形式存储，因此丢失的密钥无法找回 —— 请签发新的。

API 访问属于 Plus 方案。不具备该方案的账户，其密钥会以 NOT_ENTITLED 被拒绝。

Authorization: Bearer rlv_your_key_here

请求

POST https://rework.live/api/v1/convert，以 multipart/form-data 提交，恰好两个字段：目标格式与文件本身。字段顺序无关紧要。

curl -X POST https://rework.live/api/v1/convert \
  -H "Authorization: Bearer rlv_your_key_here" \
  -F "to=webp" \
  -F "file=@photo.png"

字段	类型	说明
to	string	目标格式 ID，例如 `pdf`、`webp`、`mp4`
file	file	要转换的文件。每个请求一个。

响应

始终是 JSON，绝不是原始字节，并且无论转换已完成还是已排队，结构始终相同。一个必须依据 Content-Type 分支来判断自己收到了什么的客户端，终究会判断错。

200 表示任务已完成且 download 可用。202 表示已排队：status_url 是轮询地址，而 download 在完成前为 null。

{
  "job": {
    "id": "6a84860000000000000000ab",
    "status": "done",
    "from": "png",
    "to": "webp",
    "bytes": 48213,
    "durationMs": 412,
    "notes": [],
    "expiresAt": "2026-09-03T10:22:31.000Z",
    "download": "https://rework.live/api/v1/jobs/6a84860000000000000000ab/download",
    "status_url": null,
    "queuePosition": null,
    "estimateMs": null
  }
}

直接获取字节

如果你想要文件本身而不是链接，请加上 ?download=1。即时完成的转换会返回字节；进入队列的转换仍会返回 202 与 JSON，因为此时还没有可发送的内容。