Konwersja pliku

Pracę wykonuje jeden punkt końcowy. Wyślij plik i format docelowy, a otrzymasz zadanie — zakończone, jeśli poszło szybko, albo w kolejce, jeśli nie.

Uwierzytelnianie

Wszystkie punkty końcowe poza katalogiem formatów wymagają klucza API wysyłanego jako token bearer. Utwórz go na stronie Automatyzacja w swoim koncie; pokazujemy go raz i przechowujemy wyłącznie jako skrót, więc utraconego klucza nie da się odzyskać — wygeneruj nowy.

Dostęp do API należy do planu Plus. Klucz konta bez tego planu jest odrzucany z kodem NOT_ENTITLED.

Authorization: Bearer rlv_your_key_here

Żądanie

POST https://rework.live/api/v1/convert, jako multipart/form-data, z dokładnie dwoma polami: formatem docelowym i samym plikiem. Kolejność pól nie ma znaczenia.

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

Pole	Typ	Opis
to	string	Identyfikator formatu docelowego, na przykład `pdf`, `webp`, `mp4`
file	file	Plik do konwersji. Jeden na żądanie.

Odpowiedź

Zawsze JSON, nigdy surowe bajty, i zawsze o tym samym kształcie — niezależnie od tego, czy konwersja się zakończyła, czy trafiła do kolejki. Klient, który musiałby patrzeć na typ zawartości, by wiedzieć, co dostał, to klient, który kiedyś się pomyli.

200 oznacza, że zadanie jest gotowe i download czeka. 202 oznacza, że trafiło do kolejki: status_url wskazuje, gdzie odpytywać, a download jest pusty do czasu zakończenia.

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

Pobranie samych bajtów

Dodaj ?download=1, jeśli wolisz plik od linku. Konwersja kończąca się od ręki zwróci wtedy bajty; ta, która trafia do kolejki, nadal zwraca 202 z JSON-em, bo nie ma jeszcze czego wysyłać.