Convertir un archivo

Un solo endpoint hace el trabajo. Envía un archivo y un formato de destino, y recibe un trabajo: terminado si fue rápido, en cola si no.

Autenticación

Todos los endpoints salvo el catálogo de formatos necesitan una clave de API, enviada como token bearer. Crea una en la página Automatizar de tu cuenta; se muestra una sola vez y se guarda solo como hash, así que una clave perdida no se puede recuperar: emite otra.

El acceso a la API forma parte del plan Plus. Una clave de una cuenta sin él se rechaza con NOT_ENTITLED.

Authorization: Bearer rlv_your_key_here

La petición

POST https://rework.live/api/v1/convert, como multipart/form-data, con exactamente dos campos: el formato de destino y el propio archivo. El orden de los campos no importa.

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

Campo	Tipo	Descripción
to	string	Identificador del formato de destino, por ejemplo `pdf`, `webp`, `mp4`
file	file	El archivo a convertir. Uno por petición.

La respuesta

Siempre JSON, nunca bytes en crudo, y siempre con la misma forma tanto si la conversión terminó como si se encoló. Un cliente que tuviera que mirar el tipo de contenido para saber qué ha recibido es un cliente que acabará equivocándose.

200 significa que el trabajo está hecho y download está listo. 202 significa que se encoló: status_url es donde consultar y download es nulo hasta que termine.

{
  "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
  }
}

Obtener los bytes directamente

Añade ?download=1 si prefieres el archivo a un enlace. Una conversión que termina al vuelo devuelve entonces los bytes; una que se encola sigue devolviendo 202 con JSON, porque todavía no hay nada que enviar.