L'API DuupFlow, point par point

L'API donne accès, sans passer par le site, aux mêmes traitements que le dashboard DuupFlow :

• Dupliquer une image en 1 à 20 copies uniques (métadonnées, pixels invisibles, identité d'appareil).
• Dupliquer une vidéo en 1 à 10 copies uniques, identiques à l'œil.
• Compresser une image sans jamais l'alourdir.
• Retirer la détection IA d'une image, ou l'activer en option sur une duplication.

Cas typiques : automatiser un flux de publication multi-comptes, brancher DuupFlow dans Make / n8n / Zapier (module HTTP), ou laisser un agent IA (Claude Code, scripts) lancer les duplications.

• Les duplications via l'API sont illimitées sur Pro et Agence — pas de quota mensuel, pas de coût à l'appel.
• Les invités d'une équipe Pro ou Agence peuvent créer leurs propres clés.
• Pas d'essai gratuit de l'API. Le Pro mensuel est sans engagement (résiliable à tout moment). Une démo personnalisée est possible via le support Telegram.
• Les prix à jour sont toujours sur la page Tarifs.

1. 1Passe sur le plan Pro ou Agence.
2. 2Dans le dashboard, ouvre Développeurs et clique sur Générer une clé.
3. 3Copie la clé tout de suite : elle n'est affichée qu'une seule fois.
4. 4Vérifie qu'elle fonctionne avec GET /me (exemple ci-dessous).
5. 5Lance ta première duplication.

curl -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  https://www.duupflow.com/api/v1/me

{ "user_id": "…", "plan": "pro", "api_version": "v1" }

• Chaque requête envoie l'en-tête Authorization: Bearer dflw_live_….
• Jusqu'à 3 clés par compte (une par intégration, par exemple).
• Une clé supprimée est désactivée immédiatement et ne peut pas être récupérée.
• Si l'abonnement passe sous le plan Pro ou se retrouve en défaut de paiement, l'API répond 403 plan_required jusqu'à régularisation.

Réponse : 1 copie → le fichier image directement ; plusieurs copies → une archive zip. Les noms de fichiers sont neutres (aucune mention de DuupFlow).

curl -X POST https://www.duupflow.com/api/v1/images/duplicate \
  -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  -F "count=3" \
  -F "iphone_meta=1" \
  -o copies.zip

• visual : micro-variations de luminosité, contraste et couleur, invisibles à l'œil.
• motion : léger mouvement de caméra.
• metadata_technical : paramètres d'encodage et métadonnées techniques uniques.
• pixel_magic : bruit imperceptible pour une empreinte unique.

La résolution et la qualité d'origine sont conservées (4K comprise), et une copie n'est jamais plus lourde que la source. Le 9:16 vertical est pris en charge.

curl -X POST https://www.duupflow.com/api/v1/videos/duplicate \
  -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  -F "file=@clip.mp4" \
  -F "count=3" \
  -F "packs=visual,motion,metadata_technical"

{
  "job_id": "3f1c…",
  "status": "queued",
  "poll_url": "https://www.duupflow.com/api/v1/jobs/3f1c…"
}

• status : queued → processing → completed ou failed.
• progress : 0 à 100 ; message : étape en cours.
• Quand completed, result.files liste chaque copie avec son url.
• Quand failed, error explique pourquoi (fichier illisible, trop long…).
• Si le serveur est momentanément saturé, le job est relancé automatiquement (il repasse en queued) — rien à faire de ton côté.

{
  "id": "3f1c…",
  "type": "videos.duplicate",
  "status": "completed",
  "progress": 100,
  "message": "Done",
  "result": {
    "files": [
      { "name": "…_c01_….mp4", "bytes": 8123456, "url": "https://www.duupflow.com/api/v1/jobs/3f1c…/files/…_c01_….mp4" }
    ]
  },
  "error": null,
  "created_at": "2026-10-29T10:00:00Z"
}

curl -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  "https://www.duupflow.com/api/v1/jobs/JOB_ID/files/FILE_NAME" -o copy.mp4

import time, requests

API = "https://www.duupflow.com/api/v1"
H = {"Authorization": "Bearer dflw_live_YOUR_KEY"}

# 1) Start the job
with open("clip.mp4", "rb") as f:
    r = requests.post(f"{API}/videos/duplicate", headers=H,
                      files={"file": f}, data={"count": "3"})
r.raise_for_status()
job_id = r.json()["job_id"]

# 2) Poll until it's done
while True:
    job = requests.get(f"{API}/jobs/{job_id}", headers=H).json()
    if job["status"] in ("completed", "failed"):
        break
    time.sleep(8)

# 3) Download every copy
if job["status"] == "completed":
    for f in job["result"]["files"]:
        data = requests.get(f["url"], headers=H).content
        open(f["name"], "wb").write(data)
else:
    print("Failed:", job["error"])

const API = "https://www.duupflow.com/api/v1";
const H = { Authorization: "Bearer dflw_live_YOUR_KEY" };

const form = new FormData();
form.append("file", new Blob([await fs.promises.readFile("clip.mp4")]), "clip.mp4");
form.append("count", "3");

const { job_id } = await (await fetch(`${API}/videos/duplicate`, { method: "POST", headers: H, body: form })).json();

let job;
do {
  await new Promise((r) => setTimeout(r, 8000));
  job = await (await fetch(`${API}/jobs/${job_id}`, { headers: H })).json();
} while (job.status === "queued" || job.status === "processing");

for (const f of job.result?.files ?? []) {
  const buf = Buffer.from(await (await fetch(f.url, { headers: H })).arrayBuffer());
  await fs.promises.writeFile(f.name, buf);
}

Dans Make, n8n ou Zapier : un module HTTP « multipart/form-data » pour lancer le job, une boucle avec temporisation (8 s) sur GET /jobs/:id, puis un module HTTP par fichier pour le télécharger.

Le résultat n'est jamais plus lourd que l'original (sinon l'original est renvoyé). Le gain est indiqué dans les en-têtes X-DuupFlow-Saved-Percent, X-DuupFlow-Original-Bytes et X-DuupFlow-Output-Bytes. La compression vidéo via l'API n'est pas encore disponible.

curl -X POST https://www.duupflow.com/api/v1/compress \
  -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  -F "file=@photo.jpg" -F "level=strong" -D headers.txt -o compressed.jpg

Efface les métadonnées de provenance IA (C2PA, XMP…) et retouche les pixels de façon invisible (grain, micro-flou, couleurs), en gardant le format et la résolution. Image jpg, png ou webp ≤ 25 Mo. Pour les vidéos, utilise l'option remove_ai_detection de /videos/duplicate.

curl -X POST https://www.duupflow.com/api/v1/ai-detection \
  -H "Authorization: Bearer dflw_live_YOUR_KEY" \
  -F "file=@image.png" -o cleaned.png

Toutes les erreurs ont le même format JSON :

{ "error": { "code": "file_too_large", "message": "File exceeds the 150 MB limit." } }

• Interroger un job toutes les 5 à 10 secondes, pas plus souvent.
• Sur 429 ou 5xx : réessayer avec un délai croissant (backoff).
• Garder la bonne extension dans le nom de fichier envoyé : c'est elle qui détermine le format.
• Télécharger les résultats dès la fin du job (ils expirent après 16 h).
• Une clé par intégration : en cas de problème, tu en coupes une sans casser les autres.
• Chaque appel produit des copies différentes : relancer la même source donne de nouvelles variantes.