API

curl https://pdfremakeit.app/v1/status

const r = await fetch("https://pdfremakeit.app/v1/status");
console.log(await r.json());
// { "status": "operational", "capacity": "normal" }

import urllib.request, json

with urllib.request.urlopen("https://pdfremakeit.app/v1/status") as r:
    print(json.load(r))
# {'status': 'operational', 'capacity': 'normal'}

# 1. Envoyer le document. La réponse porte l'identifiant du travail.
curl -X POST https://pdfremakeit.app/v1/tools/office \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "X-Source-Name: rapport.docx" \
  --data-binary @rapport.docx

# 2. Interroger le travail jusqu'à "done".
curl https://pdfremakeit.app/v1/jobs/JOB_ID \
  -H "Authorization: Bearer prk_VOTRE_CLE"

# 3. Récupérer le PDF.
curl -L https://pdfremakeit.app/v1/jobs/JOB_ID/content \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -o rapport.pdf

import { readFile, writeFile } from "node:fs/promises";

const CLE = "prk_VOTRE_CLE";
const entetes = { Authorization: `Bearer ${CLE}` };

const depart = await fetch("https://pdfremakeit.app/v1/tools/office", {
  method: "POST",
  headers: { ...entetes, "X-Source-Name": "rapport.docx" },
  body: await readFile("rapport.docx"),
});
const { id } = await depart.json();

// Un travail serveur est asynchrone : on interroge jusqu'à ce qu'il aboutisse.
let etat;
do {
  await new Promise((r) => setTimeout(r, 1500));
  etat = await (await fetch(`https://pdfremakeit.app/v1/jobs/${id}`, { headers: entetes })).json();
} while (etat.status === "queued" || etat.status === "running");

if (etat.status === "error") throw new Error(etat.error);

const pdf = await fetch(`https://pdfremakeit.app/v1/jobs/${id}/content`, { headers: entetes });
await writeFile("rapport.pdf", Buffer.from(await pdf.arrayBuffer()));

import time, requests

CLE = "prk_VOTRE_CLE"
entetes = {"Authorization": f"Bearer {CLE}"}

with open("rapport.docx", "rb") as f:
    depart = requests.post(
        "https://pdfremakeit.app/v1/tools/office",
        headers={**entetes, "X-Source-Name": "rapport.docx"},
        data=f,
    )
depart.raise_for_status()
identifiant = depart.json()["id"]

# Un travail serveur est asynchrone : on interroge jusqu'à ce qu'il aboutisse.
while True:
    time.sleep(1.5)
    etat = requests.get(f"https://pdfremakeit.app/v1/jobs/{identifiant}", headers=entetes).json()
    if etat["status"] not in ("queued", "running"):
        break

if etat["status"] == "error":
    raise RuntimeError(etat["error"])

pdf = requests.get(f"https://pdfremakeit.app/v1/jobs/{identifiant}/content", headers=entetes)
open("rapport.pdf", "wb").write(pdf.content)

curl -X POST "https://pdfremakeit.app/v1/tools/ocr?langues=fra" \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "X-Source-Name: scan.pdf" \
  --data-binary @scan.pdf

const depart = await fetch("https://pdfremakeit.app/v1/tools/ocr?langues=fra", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${CLE}`,
    "X-Source-Name": "scan.pdf",
  },
  body: await readFile("scan.pdf"),
});
const { id, links } = await depart.json();
console.log(links.self); // /v1/jobs/...

with open("scan.pdf", "rb") as f:
    depart = requests.post(
        "https://pdfremakeit.app/v1/tools/ocr",
        params={"langues": "fra"},
        headers={**entetes, "X-Source-Name": "scan.pdf"},
        data=f,
    )
print(depart.json()["id"])

curl -X POST https://pdfremakeit.app/v1/ai/summarize \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Le rapport annuel 2025 fait état d un chiffre d affaires de 184 000 euros...",
    "length": "short",
    "format": "bullets"
  }'

const r = await fetch("https://pdfremakeit.app/v1/ai/summarize", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${CLE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text, length: "short", format: "bullets" }),
});
const { text: resume, partial } = await r.json();
// `partial` vaut true si le traitement s'est interrompu : le texte reste
// utilisable, mais il est incomplet.
console.log(resume);

r = requests.post(
    "https://pdfremakeit.app/v1/ai/summarize",
    headers={**entetes, "Content-Type": "application/json"},
    json={"text": texte, "length": "short", "format": "bullets"},
)
resultat = r.json()
# `partial` vaut True si le traitement s'est interrompu : le texte reste
# utilisable, mais il est incomplet.
print(resultat["text"])

curl -N -X POST https://pdfremakeit.app/v1/ai/translate \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"text": "Bonjour le monde.", "targetLanguage": "en", "stream": true}'

# {"t":"debut","blocs":1,...}
# {"t":"texte","v":"Hello"}
# {"t":"texte","v":" world."}
# {"t":"fin","caracteres":12}

const r = await fetch("https://pdfremakeit.app/v1/ai/translate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${CLE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text, targetLanguage: "en", stream: true }),
});

const lecteur = r.body.pipeThrough(new TextDecoderStream()).getReader();
let reste = "";
for (;;) {
  const { done, value } = await lecteur.read();
  if (done) break;
  reste += value;
  let saut;
  while ((saut = reste.indexOf("\n")) !== -1) {
    const ligne = reste.slice(0, saut);
    reste = reste.slice(saut + 1);
    if (!ligne) continue;
    const evenement = JSON.parse(ligne);
    if (evenement.t === "texte") process.stdout.write(evenement.v);
  }
}

import json, requests

with requests.post(
    "https://pdfremakeit.app/v1/ai/translate",
    headers={**entetes, "Content-Type": "application/json"},
    json={"text": texte, "targetLanguage": "en", "stream": True},
    stream=True,
) as r:
    for ligne in r.iter_lines():
        if not ligne:
            continue
        evenement = json.loads(ligne)
        if evenement["t"] == "texte":
            print(evenement["v"], end="", flush=True)

# 1. Enregistrer l'enchaînement. Rendu une fois pour toutes.
curl -X POST https://pdfremakeit.app/v1/workflows \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Courrier scanné",
       "steps":[{"tool":"ocr","settings":{"langues":"fra"}},
                {"tool":"pdfa","settings":{"niveau":"2b"}}]}'

# 2. Le lancer sur un document. Le quota des deux étapes est réservé ici.
curl -X POST https://pdfremakeit.app/v1/workflows/WORKFLOW_ID/run \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -H "X-Source-Name: courrier.pdf" \
  --data-binary @courrier.pdf

# 3. Suivre, puis récupérer le PDF de la dernière étape.
curl https://pdfremakeit.app/v1/runs/RUN_ID -H "Authorization: Bearer prk_VOTRE_CLE"
curl -L https://pdfremakeit.app/v1/runs/RUN_ID/content \
  -H "Authorization: Bearer prk_VOTRE_CLE" \
  -o archive.pdf

import { readFile, writeFile } from "node:fs/promises";

const chaine = await (
  await fetch("https://pdfremakeit.app/v1/workflows", {
    method: "POST",
    headers: { ...entetes, "Content-Type": "application/json" },
    body: JSON.stringify({
      name: "Courrier scanné",
      steps: [
        { tool: "ocr", settings: { langues: "fra" } },
        { tool: "pdfa", settings: { niveau: "2b" } },
      ],
    }),
  })
).json();

const depart = await fetch(`https://pdfremakeit.app/v1/workflows/${chaine.id}/run`, {
  method: "POST",
  headers: { ...entetes, "X-Source-Name": "courrier.pdf" },
  body: await readFile("courrier.pdf"),
});
let execution = await depart.json();

// Une étape peut durer plusieurs minutes : on interroge, on n'attend pas.
while (execution.status === "running") {
  await new Promise((f) => setTimeout(f, 3000));
  execution = await (
    await fetch(`https://pdfremakeit.app/v1/runs/${execution.id}`, { headers: entetes })
  ).json();
  const etape = Math.min(execution.step + 1, execution.totalSteps);
  console.log(`étape ${etape} / ${execution.totalSteps}`);
}
if (execution.status !== "done") throw new Error(execution.error);

const pdf = await fetch(`https://pdfremakeit.app/v1/runs/${execution.id}/content`, {
  headers: entetes,
});
await writeFile("archive.pdf", Buffer.from(await pdf.arrayBuffer()));

import time, requests

chaine = requests.post(
    "https://pdfremakeit.app/v1/workflows",
    headers={**entetes, "Content-Type": "application/json"},
    json={
        "name": "Courrier scanné",
        "steps": [
            {"tool": "ocr", "settings": {"langues": "fra"}},
            {"tool": "pdfa", "settings": {"niveau": "2b"}},
        ],
    },
).json()

with open("courrier.pdf", "rb") as f:
    execution = requests.post(
        f"https://pdfremakeit.app/v1/workflows/{chaine['id']}/run",
        headers={**entetes, "X-Source-Name": "courrier.pdf"},
        data=f,
    ).json()

while execution["status"] == "running":
    time.sleep(3)
    execution = requests.get(
        f"https://pdfremakeit.app/v1/runs/{execution['id']}", headers=entetes
    ).json()
    etape = min(execution["step"] + 1, execution["totalSteps"])
    print(f"etape {etape} / {execution['totalSteps']}")

if execution["status"] != "done":
    raise SystemExit(execution["error"])

pdf = requests.get(
    f"https://pdfremakeit.app/v1/runs/{execution['id']}/content", headers=entetes
)
open("archive.pdf", "wb").write(pdf.content)

curl -X POST https://pdfremakeit.app/v1/runs/RUN_ID/replay \
  -H "Authorization: Bearer prk_VOTRE_CLE"

const rejeu = await fetch(`https://pdfremakeit.app/v1/runs/${execution.id}/replay`, {
  method: "POST",
  headers: entetes,
});

if (rejeu.status === 410) {
  // Le document d'origine a été purgé : il faut le renvoyer.
  console.log("source expirée, relancer le workflow avec le fichier");
} else {
  console.log("nouvelle exécution :", (await rejeu.json()).id);
}

rejeu = requests.post(
    f"https://pdfremakeit.app/v1/runs/{execution['id']}/replay", headers=entetes
)

if rejeu.status_code == 410:
    print("source expiree, relancer le workflow avec le fichier")
else:
    print("nouvelle execution :", rejeu.json()["id"])

curl https://pdfremakeit.app/v1/account \
  -H "Authorization: Bearer prk_VOTRE_CLE"

const compte = await (
  await fetch("https://pdfremakeit.app/v1/account", { headers: entetes })
).json();

const { used, limit } = compte.usage.serverJobs;
console.log(`${used} / ${limit} travaux aujourd'hui`);

compte = requests.get("https://pdfremakeit.app/v1/account", headers=entetes).json()

usage = compte["usage"]["serverJobs"]
print(f"{usage['used']} / {usage['limit']} travaux aujourd'hui")