uncloth.app Guides
Résultat généré par l'API uncloth.app

Filtres pour adultes
pour vos applications

Un endpoint. Onze presets. Envoyez une photo, récupérez un résultat fini — au volume auquel tourne votre plateforme.

Conçue pour tourner en production

uncloth.app est une API de transformation d'images destinée aux plateformes qui ont besoin d'images générées comme composant fiable de leur produit, et non comme expérimentation. Vous envoyez une photo et le preset voulu. Nous renvoyons le résultat fini.

Tout ce qui se trouve derrière l'endpoint est à notre charge — capacité, file d'attente, livraison et reprise. Votre intégration tient en un seul appel HTTP authentifié et, si vous voulez la progression en direct, une connexion WebSocket.

Rien dans la requête ne dépend de notre niveau de charge. Le même appel se comporte de la même façon le premier jour et en pic de charge.

Une photo, tous les presets

Chaque résultat ci-dessous provient de la même photographie source, sans rien changer d'autre que l'id du preset dans la requête.

Onze presets

Passez feature=<id> avec le job. Sans ce paramètre, la requête retombe sur undress. Un id inconnu est rejeté avec la liste des valeurs valides, de sorte qu'une faute de frappe échoue franchement au lieu de renvoyer une mauvaise image.

01
Bikinifeature=bikini
02
Taille de poitrinefeature=breast_size
03
Tenue de lapinefeature=bunny_suit
04
Lingerie en dentellefeature=lace_lingerie
05
Shibarifeature=shibari
06
Basfeature=stocking
07
Tatouagefeature=tattoo
08
DéshabillerPar défautfeature=undress
09
Tenue de pom-pom girlfeature=cheerleader_outfit
10
Tenue de footballfeature=footy
11
Poitrine dénudéefeature=flash_tits

Quatre appels, du début à la fin

01

Envoyez la photo

Un POST multipart avec l'image, le preset et une confirmation de consentement. Un id de job vous est renvoyé immédiatement.

02

Suivez le job

Interrogez l'endpoint du job ou abonnez-vous au WebSocket pour recevoir les événements de progression en direct pendant le traitement.

03

Récupérez le résultat

Un job terminé porte un id d'artefact. Récupérez-le avec la même clé et vous obtenez les octets de l'image.

04

Réessayez sans frais

Répétez l'appel avec le même Idempotency-Key et vous récupérez le job d'origine. Une nouvelle tentative ne produit jamais un second résultat.

L'intégration complète

Un seul en-tête authentifie chaque appel. Chaque réponse est limitée au client propriétaire de la clé — jobs, événements et résultats compris.

POST/api/v1/jobsCréer un job. Multipart : image, feature, consent. En-tête Idempotency-Key.
GET/api/v1/jobs/:idStatut du job, progression et id du résultat.
GET/api/v1/artifacts/:idTélécharger l'image générée.
GET/api/v1/featuresLister les presets. Public, aucune clé requise.
WS/api/v1/wsÉvénements job.updated en direct après un message d'authentification.

Votre URL de base est délivrée avec votre clé.

Créer un job
curl -X POST https://api.uncloth.app/api/v1/jobs \
  -H "X-API-Key: $UNCLOTH_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F feature=bikini \
  -F consent=confirmed \
  -F image=@photo.jpg

# { "data": { "id": "job_...", "status": "queued" } }
Récupérer le résultat
curl -H "X-API-Key: $UNCLOTH_KEY" \
  https://api.uncloth.app/api/v1/jobs/JOB_ID

# { "data": { "status": "succeeded",
#     "outputs": [ { "id": "art_..." } ] } }

curl -H "X-API-Key: $UNCLOTH_KEY" \
  https://api.uncloth.app/api/v1/artifacts/ART_ID \
  -o result.png

Conçue pour continuer à répondre

Nous exploitons la capacité, la file d'attente et le chemin de livraison pour que votre plateforme n'ait pas à le faire. Ce sont des engagements sur la façon dont le service est construit et exploité.

Supprimé en 10 minutes

Votre image est supprimée de nos systèmes 10 minutes après réception du résultat. Rien n'est conservé à des fins d'entraînement, de contrôle ou autre.

Objectif de disponibilité 99,9 %

Le niveau de service que nous concevons, exploitons et mesurons, suivi en bordure de l'API plutôt que sur un composant particulier.

Infrastructure globale

Les requêtes sont servies par une capacité distribuée, de sorte que la demande dans une région ne devient pas une file d'attente pour tous les autres.

Mise à l'échelle automatique

La capacité suit la charge. Un pic de trafic change le débit, jamais la forme de l'API ni la manière dont votre code doit l'appeler.

Bascule par défaut

Tout composant peut être vidé ou remplacé sans interruption que vous auriez à gérer. Le travail en cours est repris, pas perdu.

Isolation par clé

Une clé ne voit que ses propres jobs, événements et résultats. Les réponses n'exposent jamais d'identifiants internes ni de détails d'infrastructure.

Idempotence contractuelle

L'en-tête Idempotency-Key rend les nouvelles tentatives sûres. Une répétition renvoie le job d'origine au lieu d'effectuer le travail deux fois.

File d'attente durable

Le travail accepté est enregistré avant de démarrer et repris ensuite. Un redémarrage à n'importe quel point du chemin ne fait pas perdre votre job.

Validation stricte des entrées

JPEG, PNG et WebP jusqu'à 20 MiB, vérifiés par leur contenu et pas seulement par le nom ou le type déclaré du fichier.

Questions fréquentes

Comment s'authentifier ?

Un en-tête X-API-Key sur les appels REST. Sur le WebSocket, la clé voyage dans le premier message après connexion, elle n'apparaît donc jamais dans une URL ni dans un journal de proxy.

Que se passe-t-il si une requête expire ?

Répétez-la avec le même Idempotency-Key. Vous récupérez le job d'origine, et aucun second résultat n'est produit.

Quels formats et quelles tailles sont acceptés ?

JPEG, PNG et WebP jusqu'à 20 MiB. Le contenu réel du fichier est vérifié, un fichier renommé ou mal déclaré est donc rejeté.

Puis-je appliquer plusieurs presets à une même photo ?

Oui. Chaque preset constitue son propre job : soumettez un job par preset avec la même image source et suivez-les indépendamment.

Suis-je obligé d'interroger l'API en boucle ?

Non. Connectez-vous au WebSocket, authentifiez-vous, et vous recevez un instantané de vos jobs récents puis les mises à jour en direct. L'interrogation reste disponible en solution de repli.

Le consentement est-il imposé ?

Oui. Un appel de création sans consent=confirmed est rejeté à la frontière de l'API. C'est un champ obligatoire et une déclaration dont vous êtes responsable.

Quel est le coût ?

La tarification dépend du volume et est communiquée avec l'accès. Parlez-nous de votre plateforme et du débit attendu, et nous reviendrons vers vous avec des chiffres.

Conservez-vous mes images ?

Les images sources et les résultats sont conservés dans un stockage privé et servis uniquement à la clé qui les a créés. Les conditions de rétention sont convenues dans le cadre de l'accès.

Dites-nous ce que vous construisez

L'accès est accordé par intégration. Décrivez votre plateforme, le volume attendu et la manière dont vous recueillez le consentement des personnes présentes sur les images, et nous vous renverrons des identifiants et une URL de base.

Pas d'inscription publique. Pas de clés en libre-service.