API documentation

With the Do4U API you use the same tools as on the website from your own software: summarise, compare, support replies, alt texts, rewrite and translate. Every request is processed on our own servers in Poland, EU.

Base URL: https://do4u.eu/api/v1

OpenAPI 3.1 description (JSON) – Machine-readable description of this API for code generators and tools such as Postman or Insomnia. No key needed.

Authentication

Create a key under API keys in your account. Send it with every request in the header Authorization: Bearer <key> (or X-API-Key: <key>). Keep the key secret and never put it into a web page. You can revoke a key at any time.

How it works

Jobs run asynchronously. You create a job and get its id at once (HTTP 202). Then you fetch the job until its status is done or failed. Ask every 2 to 5 seconds; most jobs take a few seconds.

Endpoints

Example

Create a job, then fetch the result:

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "...", "options": {"length": "short"}, "language": "en"}'

HTTP/1.1 202 Accepted
{"id": "8f1c0b6a...", "tool": "summarize", "status": "queued", "model": "do4u-standard",
 "credits_estimate": 1, "links": {"self": "https://do4u.eu/api/v1/jobs/8f1c0b6a..."}}

curl https://do4u.eu/api/v1/jobs/8f1c0b6a... -H "Authorization: Bearer d4u_YOUR_KEY"

{"id": "8f1c0b6a...", "tool": "summarize", "status": "done", "model": "do4u-standard", "credits_estimate": 1,
 "result": {"summary": "...", "key_points": ["...", "..."]}, "credits": 1,
 "notice": "AI-generated, please check before use."}

curl -X POST https://do4u.eu/api/v1/jobs -H "Authorization: Bearer d4u_YOUR_KEY" \
  -F tool=alt_text -F language=de -F "text=Product page: hiking boots" -F image=@photo.jpg

Request fields for POST /jobs

Repeat requests safely (Idempotency-Key)

Send the header Idempotency-Key with POST /jobs, for example a random UUID for each job (1 to 255 printable ASCII characters). If the connection breaks and you send the same request again with the same Idempotency-Key and the same API key within 24 hours, you get the same answer again: the same job, no second job and no second charge. The answer then has the header Idempotent-Replayed: true. Use a new key for every new job. If you send the same key with a different request, you get 422 idempotency_conflict. Errors are not stored: after an error you can send the request again with the same key.

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Idempotency-Key: 5f0c2a8e-7d1b-4c3a-9e2f-1b6d8a4c0e77" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "..."}'

Tools and options

Job status

queued and running: still working (position and wait_seconds help you to wait). done: result contains the fields of the tool. failed: nothing was charged (credits is 0); error.code names the reason: address_blocked (Do4U does not open this address, for example a private or internal one; send the text or HTML instead), input_too_large (shorten the input), image_unavailable or job_failed. expired: the result is no longer stored.

Webhooks

Ajoute « callback_url » à POST /api/v1/jobs, et Do4U enverra un POST signé (événement job.finished avec statut, crédits et lien de résultat – pas le résultat lui-même) dès que le job est terminé. Uniquement des adresses publiques sur le port 80 ou 443 ; nous réessayons jusqu'à 6 fois avec des pauses croissantes.

Exemple : crée un job avec callback_url – et la requête Do4U est envoyée à cette adresse quand le job est terminé :

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool": "summarize", "text": "...", "callback_url": "https://example.com/do4u-hook"}'

POST /do4u-hook
Content-Type: application/json
X-Do4U-Event: job.finished
X-Do4U-Signature: t=1793180000,v1=6b1f...

{"event":"job.finished","id":"8f1c0b6a...","tool":"summarize","status":"done","credits":1,
 "created":"2026-10-28T10:00:00+01:00","finished":"2026-10-28T10:00:04+01:00","result_url":"https://do4u.eu/api/v1/jobs/8f1c0b6a..."}

Vérifie l'en-tête X-Do4U-Signature : t=<time>,v1=<hex>, où v1 = HMAC-SHA256(secret, "<time>.<raw body>"). Rejette les horodatages trop anciens (p. ex. plus de 5 minutes). Ton secret commence par whsec_ et s'affiche sur la page des clés API.

// Node.js: rawBody = the request body exactly as received (string)
const crypto = require('crypto');
function do4uSignatureOk(rawBody, header, secret) {
  const t = (header.match(/t=(\d+)/) || [])[1];
  const v1 = (header.match(/v1=([0-9a-f]{64})/) || [])[1];
  if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = crypto.createHmac('sha256', secret).update(t + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

// PHP
function do4u_signature_ok(string $raw, string $header, string $secret): bool {
    if (!preg_match('/t=(\d+),v1=([0-9a-f]{64})/', $header, $m) || abs(time() - (int)$m[1]) > 300) return false;
    return hash_equals(hash_hmac('sha256', $m[1] . '.' . $raw, $secret), $m[2]);
}
$ok = do4u_signature_ok(file_get_contents('php://input'), $_SERVER['HTTP_X_DO4U_SIGNATURE'] ?? '', 'whsec_YOUR_SECRET');

credits.low

Lorsque le solde de crédits d'un compte descend en dessous du seuil, Do4U envoie un POST signé à l'adresse webhook du compte. L'événement ne contient aucune donnée personnelle, seulement le solde, le seuil et l'heure (UTC). Le suivant ne suit qu'après l'ajout de nouveaux crédits (achat, crédits gratuits mensuels ou bon). La signature et le secret sont les mêmes que pour job.finished.

POST /do4u-hook
Content-Type: application/json
X-Do4U-Event: credits.low
X-Do4U-Signature: t=1793180000,v1=6b1f...

{"event":"credits.low","balance":18,"threshold":20,"ts":"2026-10-29T10:00:04Z"}

Tu configures l'adresse et le seuil ici : Clés API

n8n

Workflow prêt à l'emploi : un webhook reçoit l'appel de Do4U, vérifie la signature, récupère le résultat et le transmet à ton étape suivante.

Télécharger le modèle n8n (JSON)

Modèle non encore testé dans une instance n8n ou Make réelle – merci de tester la vérification de la signature avant de l'utiliser.

Dans n8n : Workflows → Import from file. Ensuite, saisis ton secret dans le nœud "Check signature" et ta clé API dans "Do4U: get result", active le workflow et utilise l'URL de production du webhook comme callback_url. Un n8n auto-hébergé nécessite la variable d'environnement NODE_FUNCTION_ALLOW_BUILTIN=crypto pour la vérification de la signature.

Make

1. Ajoute le module Webhooks → Custom webhook comme déclencheur et active "JSON pass-through" et "Get request headers" dans ses paramètres avancés.
2. Utilise l'adresse de ce webhook comme callback_url.
3. Vérifie la signature : compare v1 de l'en-tête X-Do4U-Signature avec sha256(t + "." + corps brut; hex; ton secret).
4. Ajoute HTTP → Make a request : GET sur result_url avec l'en-tête Authorization: Bearer <your API key>.
5. Utilise le champ result dans tes modules suivants.

Modèle non encore testé dans une instance n8n ou Make réelle – merci de tester la vérification de la signature avant de l'utiliser.

Recettes : outils en chaîne

Une recette exécute 2 à 4 outils l'un après l'autre comme un seul travail. Envoie "recipe" au lieu de "tool" : soit le nom d'une recette prête à l'emploi, soit une liste d'étapes. Le texte est envoyé à la première étape ; le résultat de chaque étape est le texte pour l'étape suivante. GET /api/v1/recipes liste les recettes prêtes à l'emploi, les outils que tu peux utiliser et le champ transmis par chaque outil.

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": [{"tool": "summarize", "options": {"length": "short"}},
               {"tool": "translate", "options": {"target": "pl"}}], "text": "..."}'

curl -X POST https://do4u.eu/api/v1/jobs \
  -H "Authorization: Bearer d4u_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": "summary_translate_meta", "options": {"target": "pl"}, "text": "..."}'

Tu reçois une estimation pour toutes les étapes (credits_estimate). Ce montant est réservé au début. Après chaque étape, l'utilisation réelle est débitée et le reste reste réservé jusqu'à la fin, puis il est libéré. Une étape échouée ne coûte rien, les étapes restantes sont ignorées, et les étapes déjà terminées sont facturées.

HTTP/1.1 202 Accepted
{"id": "3c9e0d1a...", "tool": "recipe", "recipe": null, "status": "queued", "model": "do4u-standard", "credits_estimate": 4,
 "steps": [{"n": 1, "tool": "summarize", "credits_estimate": 2}, {"n": 2, "tool": "translate", "credits_estimate": 2}],
 "links": {"self": "https://do4u.eu/api/v1/jobs/3c9e0d1a..."}}

GET /api/v1/jobs/{id} affiche chaque étape avec son statut (pending, queued, running, done, failed, skipped), ses crédits, une note input_shortened si le texte a dû être raccourci pour le prochain outil, et le résultat de chaque étape une fois la recette terminée. Avec no_store, les résultats ne sont affichés qu'une fois. callback_url est déclenché une fois, à la fin de la recette.

GET https://do4u.eu/api/v1/jobs/3c9e0d1a...

{"id": "3c9e0d1a...", "tool": "recipe", "status": "done", "credits_estimate": 4, "credits": 3, "steps_total": 2,
 "steps": [{"n": 1, "tool": "summarize", "status": "done", "credits": 1, "result": {"summary": "...", "key_points": ["..."]}},
           {"n": 2, "tool": "translate", "status": "done", "credits": 2, "notices": ["input_shortened"], "result": {"translation": "...", "notes": []}}],
 "result": {"translation": "...", "notes": []}}

GET https://do4u.eu/api/v1/recipes

Errors

Errors always have the same form: {"error": {"code": "...", "message": "..."}}. With 429 and 503 the header Retry-After says how many seconds to wait.

Limits

• 60 requests per minute per key and 120 per account.
• Open jobs at the same time per account: Free 3, Starter 3, Standard 5, Pro 10, for the website and the API together.
• Input: Free 8 000 characters, paid packages 30 000. Lower limits per tool: compare 20 000, alt_text 1 000, translate 12 000 (compare: both texts together).
• API keys: Free 1, Starter 1, Standard 5, Pro 10.

Credits

A new job shows an estimate (credits_estimate); charged is the actual use (credits). Failed jobs cost nothing. Free credits are used first.

Data

Inputs and results are stored for 7 days (Free) or 30 days (paid packages), then deleted. Images are deleted right after processing. Results are AI-generated: please check them before you use them.

Répondez aux e-mails sans changer de boîte de réception

Do4U ne gère pas de boîte de réception et ne stocke jamais les données d'accès à votre messagerie. Voici deux façons d'obtenir des brouillons de réponse :

S1 – Modèle pour n8n ou Make

1. Déclencheur : un nouvel e-mail dans votre boîte de réception (déclencheur IMAP dans n8n ou Make – les données d'accès restent là)
2. POST /api/v1/jobs avec l'outil support_reply, le texte de l'e-mail et no_store: true
3. Attendez quelques secondes et récupérez GET /api/v1/jobs/{id} jusqu'à ce que le statut soit

Télécharger le modèle n8n (JSON)

Dans Make, construisez le même scénario à partir des modules Email (watch emails), HTTP (make a request), Sleep et Gmail ou Outlook (create a draft).

Extensions de dev et plugins de boutique

Extrais le ZIP et lis le guide inclus. Charge l'extension du navigateur localement ; vérifie d'abord les plugins de boutique dans une boutique de test. Ta propre clé API Dev est requise. Shopware propose actuellement une interface en ligne de commande (CLI).

• Do4U pour WordPress (ZIP)
• Chrome / Firefox · Dev (ZIP)
• WooCommerce · Dev (ZIP)
• Shopware · CLI · Dev (ZIP)