格式目录

一个公开且无需认证的端点会返回我们所转换的一切以及格式之间的每条路径。请基于它构建你的界面,而不是把列表写死在代码里。

无需密钥

GET https://rework.live/api/v1/formats 无需认证。它是一份能力清单而非数据,为了知道一项服务能转换什么就要求密钥,是一种小小的不友好 —— 那也意味着没有人能在付费之前评估这套 API。

响应可缓存一小时。请在启动时获取,而不是每次请求都取。

curl https://rework.live/api/v1/formats

返回的内容

两个数组。formats 描述我们能读或能写的每一种格式;conversions 是它们之间的每一条边。

{
  "formats": [
    {
      "id": "png",
      "label": "PNG",
      "kind": "image",
      "extensions": ["png"],
      "mime": "image/png"
    }
  ],
  "conversions": [
    {
      "from": "png",
      "to": "webp",
      "fidelity": "high",
      "async": false,
      "maxInputMb": 200,
      "options": []
    }
  ]
}
字段说明
from / to该边连接的格式 ID
fidelity该转换的保真程度
async当该转换进入队列而非即时执行时为真
maxInputMb这一具体转换所接受的最大输入
options该转换接受的额外参数(如果有)

上限有两个,不是一个

maxInputMb 是该具体转换的上限。你的方案有自己的上限,实际生效的是两者中较小的那个。即使在 Plus 账户上,若转换本身接受的更少,400 MB 的视频依然会失败。