O catálogo de formatos

Um único endpoint público e sem autenticação devolve tudo o que convertemos e todos os caminhos entre formatos. Construa a sua interface a partir dele em vez de fixar uma lista no código.

Não é preciso chave

GET https://rework.live/api/v1/formats não precisa de autenticação. É uma lista de capacidades e não dados, e exigir uma chave para saber o que um serviço converte é uma pequena hostilidade — significaria também que ninguém pode avaliar a API antes de a pagar.

A resposta pode ficar em cache durante uma hora. Peça-a no arranque, não a cada pedido.

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

O que vem de volta

Duas listas. formats descreve cada formato que sabemos ler ou escrever; conversions é cada aresta entre eles.

{
  "formats": [
    {
      "id": "png",
      "label": "PNG",
      "kind": "image",
      "extensions": ["png"],
      "mime": "image/png"
    }
  ],
  "conversions": [
    {
      "from": "png",
      "to": "webp",
      "fidelity": "high",
      "async": false,
      "maxInputMb": 200,
      "options": []
    }
  ]
}

Campo	Descrição
from / to	Identificadores de formato que a aresta liga
fidelity	Quão fiel é a conversão
async	Verdadeiro quando esta conversão vai para a fila em vez de correr de imediato
maxInputMb	Maior entrada que esta conversão em concreto aceita
options	Parâmetros adicionais que esta conversão aceita, se existirem

Dois tetos, não um

maxInputMb é o teto dessa conversão em concreto. O seu plano tem o dele, e aplica-se o menor dos dois. Um vídeo de 400 MB numa conta Plus falha na mesma se a própria conversão aceitar menos.