uncloth.app Guides
Ergebnis, erzeugt von der uncloth.app-API

Adult-Filter
für Ihre Apps

Ein Endpunkt. Elf Presets. Senden Sie ein Foto und erhalten Sie ein fertiges Ergebnis — in jedem Volumen, in dem Ihre Plattform arbeitet.

Zugang anfragen API ansehen

Für den Produktivbetrieb gebaut

uncloth.app ist eine API zur Bildtransformation für Plattformen, die generierte Bilder als verlässlichen Teil ihres Produkts brauchen und nicht als Experiment. Sie senden ein Foto und das gewünschte Preset. Wir liefern das fertige Ergebnis zurück.

Alles hinter dem Endpunkt betreiben wir — Kapazität, Warteschlange, Auslieferung und Wiederherstellung. Ihre Integration ist ein einziger authentifizierter HTTP-Aufruf und, wenn Sie den Fortschritt live sehen wollen, eine WebSocket-Verbindung.

Nichts an der Anfrage hängt davon ab, wie ausgelastet wir sind. Derselbe Aufruf verhält sich am ersten Tag genauso wie unter Spitzenlast.

Ein Foto, alle Presets

Jedes Ergebnis unten stammt aus derselben Ausgangsaufnahme; verändert wurde nur die Preset-id in der Anfrage.

Elf Presets

Übergeben Sie feature=<id> mit dem Job. Ohne Angabe fällt die Anfrage auf undress zurück. Eine unbekannte id wird zusammen mit der Liste der gültigen Werte abgelehnt, sodass ein Tippfehler laut scheitert statt ein falsches Bild zu liefern.

01
Bikinifeature=bikini
02
Brustgrößefeature=breast_size
03
Bunny-Kostümfeature=bunny_suit
04
Spitzenwäschefeature=lace_lingerie
05
Shibarifeature=shibari
06
Strümpfefeature=stocking
07
Tattoofeature=tattoo
08
EntkleidenStandardfeature=undress
09
Cheerleader-Outfitfeature=cheerleader_outfit
10
Fußballtrikotfeature=footy
11
Entblößte Brüstefeature=flash_tits

Vier Aufrufe von Anfang bis Ende

01

Foto senden

Ein Multipart-POST mit dem Bild, dem Preset und einer Einwilligungsbestätigung. Sie erhalten sofort eine Job-id zurück.

02

Verfolgen

Fragen Sie den Job-Endpunkt ab oder abonnieren Sie den WebSocket für Fortschrittsereignisse in Echtzeit, während die Arbeit läuft.

03

Ergebnis abholen

Ein fertiger Job trägt eine Artefakt-id. Rufen Sie sie mit demselben Schlüssel ab und Sie erhalten die Bilddaten.

04

Kostenfrei wiederholen

Wiederholen Sie den Aufruf mit demselben Idempotency-Key und Sie erhalten den ursprünglichen Job zurück. Eine Wiederholung erzeugt nie ein zweites Ergebnis.

Die gesamte Integration

Ein Header authentifiziert jeden Aufruf. Jede Antwort ist auf den Kunden begrenzt, dem der Schlüssel gehört — Jobs, Ereignisse und Ergebnisse eingeschlossen.

POST/api/v1/jobsJob anlegen. Multipart: image, feature, consent. Idempotency-Key-Header.
GET/api/v1/jobs/:idJob-Status, Fortschritt und Ergebnis-id.
GET/api/v1/artifacts/:idDas erzeugte Bild herunterladen.
GET/api/v1/featuresPresets auflisten. Öffentlich, kein Schlüssel nötig.
WS/api/v1/wsLive-job.updated-Ereignisse nach einer Auth-Nachricht.

Ihre Basis-URL wird mit Ihrem Schlüssel ausgegeben.

Job anlegen
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" } }
Ergebnis abholen
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

Darauf ausgelegt, weiter zu antworten

Wir betreiben die Kapazität, die Warteschlange und den Auslieferungsweg, damit Ihre Plattform das nicht tun muss. Das sind Zusagen dazu, wie der Dienst gebaut und betrieben wird.

Löschung nach 10 Minuten

Ihr Bild wird 10 Minuten nach Erhalt des Ergebnisses aus unseren Systemen gelöscht. Nichts wird für Training, Überprüfung oder andere Zwecke aufbewahrt.

Verfügbarkeitsziel 99,9 %

Das Service-Niveau, auf das wir auslegen, das wir betreiben und an dem wir uns messen, erhoben am API-Rand statt an einer einzelnen Komponente.

Globale Infrastruktur

Anfragen werden aus verteilter Kapazität bedient, damit Nachfrage in einer Region nicht zur Warteschlange für alle anderen wird.

Automatische Skalierung

Die Kapazität folgt der Last. Eine Trafficspitze verändert den Durchsatz, nie die Form der API oder die Art, wie Ihr Code sie aufrufen muss.

Failover als Standard

Jede einzelne Komponente kann geleert oder ersetzt werden, ohne eine Unterbrechung, die Sie behandeln müssten. Laufende Arbeit wird wiederhergestellt, nicht verworfen.

Isolation pro Schlüssel

Ein Schlüssel sieht nur seine eigenen Jobs, Ereignisse und Ergebnisse. Antworten geben nie interne Kennungen oder Infrastrukturdetails preis.

Idempotent per Vertrag

Der Idempotency-Key-Header macht Wiederholungen sicher. Eine Wiederholung liefert den ursprünglichen Job zurück, statt die Arbeit zweimal auszuführen.

Dauerhafte Warteschlange

Angenommene Arbeit wird vor dem Start festgeschrieben und danach wiederhergestellt. Ein Neustart an irgendeiner Stelle des Wegs verwirft Ihren Job nicht.

Strenge Eingabeprüfung

JPEG, PNG und WebP bis 20 MiB, geprüft anhand des Inhalts und nicht nur anhand des Namens oder des angegebenen Dateityps.

Häufige Fragen

Wie authentifiziere ich mich?

Ein X-API-Key-Header bei REST-Aufrufen. Beim WebSocket wandert der Schlüssel in der ersten Nachricht nach dem Verbinden, er taucht also nie in einer URL oder einem Proxy-Log auf.

Was passiert bei einem Timeout der Anfrage?

Wiederholen Sie sie mit demselben Idempotency-Key. Sie erhalten den ursprünglichen Job zurück, und es entsteht kein zweites Ergebnis.

Welche Formate und Größen werden akzeptiert?

JPEG, PNG und WebP bis 20 MiB. Der tatsächliche Inhalt der Datei wird geprüft, eine umbenannte oder falsch deklarierte Datei wird abgelehnt.

Kann ich mehrere Presets auf ein Foto anwenden?

Ja. Jedes Preset ist ein eigener Job, senden Sie also einen Job pro Preset mit demselben Ausgangsbild und verfolgen Sie sie unabhängig voneinander.

Muss ich pollen?

Nein. Verbinden Sie sich mit dem WebSocket, authentifizieren Sie sich, und Sie erhalten eine Momentaufnahme Ihrer jüngsten Jobs, gefolgt von Live-Updates. Polling bleibt als Rückfallweg verfügbar.

Wird die Einwilligung erzwungen?

Ja. Ein Erstellungsaufruf ohne consent=confirmed wird an der API-Grenze abgelehnt. Es ist ein Pflichtfeld und eine Erklärung, für die Sie verantwortlich sind.

Was kostet es?

Die Preise hängen vom Volumen ab und werden mit dem Zugang genannt. Erzählen Sie uns von Ihrer Plattform und dem erwarteten Durchsatz, dann melden wir uns mit Zahlen zurück.

Behalten Sie meine Bilder?

Ausgangsbilder und Ergebnisse liegen in privatem Speicher und werden nur an den Schlüssel ausgeliefert, der sie erzeugt hat. Aufbewahrungsbedingungen werden im Rahmen des Zugangs vereinbart.

Erzählen Sie uns, was Sie bauen

Zugang wird pro Integration vergeben. Beschreiben Sie Ihre Plattform, das erwartete Volumen und wie Sie die Einwilligung der abgebildeten Personen einholen, dann senden wir Zugangsdaten und eine Basis-URL zurück.

Keine öffentliche Registrierung. Keine Self-Service-Schlüssel.