Bild oder Video prüfen

POST https://detect.samsa.ai/v1/public/detect

Lade ein einzelnes Bild oder Video als multipart/form-data hoch. Die Antwort enthält ein detected-Gesamturteil sowie eine Aufschlüsselung je Technik. Keine Authentifizierung, keine Credits. Der Upload wird im Arbeitsspeicher verarbeitet und niemals gespeichert.

Request

Sende genau einen File-Part mit dem Namen file. Der Part muss in seinem Content-Disposition-Header einen filename tragen — ein einfaches Formularfeld ohne Dateinamen ist kein File-Part.


Content-Type	`multipart/form-data`
Feld	`file` — das zu prüfende Bild oder Video
Maximale Größe	50 MB
Bildformate	JPEG, PNG, WebP, GIF
Videoformate	MP4, QuickTime, WebM

JPEG/PNG/WebP/GIF und MP4/QuickTime werden anhand von Magic Bytes erkannt. Ein falscher oder generischer Content-Type des Parts (zum Beispiel application/octet-stream) verhindert die Erkennung bei diesen Formaten also nicht. WebM hat keinen Magic-Byte-Zweig und wird nur akzeptiert, wenn der Part Content-Type: video/webm deklariert.

curl -X POST https://detect.samsa.ai/v1/public/detect \
  -F "file=@photo.jpg"

import requests

with open("photo.jpg", "rb") as fh:
    response = requests.post(
        "https://detect.samsa.ai/v1/public/detect",
        files={"file": ("photo.jpg", fh, "image/jpeg")},
        timeout=120,
    )

response.raise_for_status()
result = response.json()
print(result["detected"])

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

const form = new FormData();
// The third argument sets the part filename — required for it to count as a file part.
form.append("file", new Blob([await readFile("photo.jpg")]), "photo.jpg");

const response = await fetch("https://detect.samsa.ai/v1/public/detect", {
  method: "POST",
  body: form,
});

if (!response.ok) {
  const { detail } = await response.json();
  throw new Error(`Detection failed (${response.status}): ${detail}`);
}

const result = await response.json();
console.log(result.detected);

Response

200 OK. Ein Bild oder Video, das ein gültiges, vertrauenswürdiges Samsa-C2PA-Manifest trägt:

Response

{
  "request_id": "c1a2b3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "detected": "samsa",
  "techniques": [
    {
      "type": "metadata",
      "technique_id": "c2pa",
      "result": "samsa",
      "confidence": "high",
      "manifest": {
        "claim_generator": "Samsa/1.0",
        "digital_source_type": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia",
        "upstream_provider": "fal",
        "upstream_model": "flux-pro",
        "timestamp": "2026-07-02T14:21:07+00:00",
        "assertions": ["c2pa.actions", "c2pa.hash.data"]
      }
    },
    {
      "type": "watermark",
      "technique_id": "trustmark-q",
      "result": "absent",
      "confidence": "low",
      "vendor_id": null
    },
    {
      "type": "watermark",
      "technique_id": "pixelseal",
      "result": "samsa",
      "confidence": "high",
      "vendor_id": "samsa-pixelseal-v1"
    }
  ],
  "external_verification": {
    "c2pa": "https://verify.contentauthenticity.org"
  },
  "result_pdf_url": "https://detect.samsa.ai/v1/public/detect/result/c1a2b3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/pdf",
  "responded_at": "2026-07-02T14:21:09.412093Z"
}

Feld	Typ	Beschreibung
`request_id`	string (UUID)	Serverseitig erzeugte ID dieser Prüfung. Nutze sie, um die signierte Ergebnis-PDF abzurufen.
`detected`	enum	Das Gesamturteil: `samsa`, `non_samsa` oder `unknown`.
`techniques[]`	array	Ein Eintrag je angewandter Technik — siehe unten.
`external_verification`	object	Links, um das Ergebnis unabhängig von Samsa zu prüfen. Aktuell `c2pa`.
`result_pdf_url`	string \| null	Link zur signierten PDF dieses Ergebnisses, oder `null`, wenn die Ergebnis-Persistenz nicht verfügbar ist.
`responded_at`	string (ISO 8601)	Wann die Prüfung abgeschlossen wurde, in UTC.

result_pdf_url kann null sein. Wenn die URL vorhanden ist, folge ihr genau so, wie sie zurückgegeben wurde, statt sie selbst zusammenzusetzen — sie und der dokumentierte Ergebnis-Endpoint liefern dieselbe signierte PDF.

Das `detected`-Urteil

Das Urteil stammt aus der C2PA-Manifest-Prüfung, die maßgeblich ist. Wasserzeichen-Techniken sind Bestätigung: Sie können eine Zuordnung liefern, wenn kein Manifest vorhanden ist, überschreiben ein Manifest-Urteil aber nie.

`detected`	Wird erreicht, wenn
`samsa`	Ein gültiges, vertrauenswürdiges, freigegebenes Samsa-Manifest geprüft wurde — oder, wenn kein Manifest vorhanden ist, eine Wasserzeichen-Erkennung einen Samsa-Treffer geliefert hat.
`non_samsa`	Ein Manifest ist vorhanden, lässt sich aber nicht Samsa zuordnen (anderer Aussteller, nicht vertrauenswürdig oder manipuliert).
`unknown`	Kein Manifest vorhanden und kein Wasserzeichen-Treffer.

unknown bedeutet, dass diese Prüfung keine Belege gefunden hat — nicht, dass die Datei authentisch oder von Menschen erstellt ist. Herkunfts-Metadaten lassen sich leicht entfernen, und für Videos ist die gehostete Wasserzeichen-Erkennung noch nicht verfügbar.

Die Techniken im Detail

techniques[] beginnt immer mit dem einzelnen metadata-Eintrag (der maßgeblichen C2PA-Ebene), gefolgt von den Wasserzeichen-Techniken, die für die Modalität der Datei gelten.

Die `metadata`-Technik

{
  "type": "metadata",
  "technique_id": "c2pa",
  "result": "absent",
  "confidence": "low",
  "manifest": null
}

Feld	Beschreibung
`technique_id`	Für diesen Eintrag immer `c2pa`.
`result`	`samsa` (gültiges, vertrauenswürdiges, freigegebenes Samsa-Manifest), `non_samsa` (Manifest eines anderen Ausstellers oder gültig, aber nicht vertrauenswürdig), `tampered` (Manifest besteht die Prüfung nicht) oder `absent` (kein Manifest — meist, weil es entfernt wurde).
`confidence`	`high`, `medium` oder `low`. Bei dieser Technik immer vorhanden.
`manifest`	Eine laienverständliche Zusammenfassung des geprüften Manifests (`claim_generator`, `digital_source_type`, `upstream_provider`, `upstream_model`, `timestamp`, `assertions`), oder `null`, wenn es nichts zusammenzufassen gibt.

Die C2PA-Manifest-Prüfung ist live: Sie wird von der öffentlichen Samsa-API und von jedem unabhängigen C2PA-Validator bereitgestellt.

Wasserzeichen-Techniken

{
  "type": "watermark",
  "technique_id": "pixelseal",
  "result": "samsa",
  "confidence": "high",
  "vendor_id": "samsa-pixelseal-v1"
}

Feld	Beschreibung
`technique_id`	`trustmark-q` oder `pixelseal` bei Bildern, `video-seal` bei Videos. Immer vorhanden, auch bei `not_checked`.
`result`	`samsa`, `absent`, `low_confidence` oder `not_checked` — siehe Tabelle unten.
`confidence`	`high`, `medium` oder `low`, und `null` genau dann, wenn `result` gleich `not_checked` ist. Der Schlüssel ist immer vorhanden.
`vendor_id`	Benennt den Decoder, der einen Treffer geliefert hat (`samsa-trustmark-v1`, `samsa-pixelseal-v1`); `null`, sofern `result` nicht `samsa` ist.

`result`	Bedeutung
`samsa`	Ein Decoder lief und fand ein Samsa-Wasserzeichen.
`absent`	Ein Decoder lief und fand kein Samsa-Wasserzeichen.
`low_confidence`	Ein Decoder lief und lieferte einen schwachen Treffer.
`not_checked`	Das Decoder-Backend ist nicht bereitgestellt, die Technik wurde also nie ausgewertet.

Die gehostete Erkennung ist für beide Bild-Techniken live, mit bewusst unterschiedlicher Konfidenz-Semantik:

TrustMark Q (trustmark-q) deckt den Altbestand ab — Bilder, die markiert wurden, als TrustMark der Embed-Anbieter war — und bleibt für diesen Bestand dauerhaft verfügbar. Die Konfidenz beschreibt den Abgleich: high ist ein exakter Payload-Treffer, medium ein Treffer innerhalb des Fehlerkorrektur-Radius des Codes, und ein schwaches Restsignal meldet low_confidence — niemals ein falsches „kein Wasserzeichen“.
Meta PixelSeal (pixelseal) ist das aktuelle Bild-Wasserzeichen — neu erzeugte Samsa-Bilder tragen PixelSeal. Über das Vorhandensein entscheidet die Bit-Genauigkeit gegenüber der Anbieter-Payload an einem festen Schwellenwert; unterhalb des Schwellenwerts lautet das Ergebnis absent. Dieser Weg hat bewusst kein low_confidence-Band.

not_checked ist keine Aussage darüber, dass kein Wasserzeichen vorhanden ist — das bedeutet absent. Die gehostete Video-Wasserzeichen-Erkennung ist noch nicht verfügbar; sie ist vor dem 2. Februar 2027 geplant. Bis dahin meldet die API die video-seal-Technik als not_checked, niemals als falsches „kein Wasserzeichen“. Stelle eine not_checked-Technik nie als fehlendes Wasserzeichen dar.

In jedem Weg meldet ein Decoder, der nicht laufen kann, not_checked, niemals ein konstruiertes absent. Die Algorithmus-IDs, die Hashes der gepinnten Modell-Artefakte, die Soft-Binding-Labels je Signaturweg und die quelloffenen Decoder hinter jeder Technik findest du unter So funktioniert die Erkennung oder über GET /v1/public/detect/info.

Fehler

Fehler kommen als {"detail": "…"} zurück — nicht als Error-Envelope der Samsa-REST-API.

Status	Wann
`400`	Fehlerhafter Multipart-Body, fehlende Boundary, leerer Upload oder eine andere Anzahl File-Parts als genau einer.
`413`	Der Upload überschreitet das Limit von 50 MB.
`415`	Der Request ist kein `multipart/form-data`, oder die hochgeladenen Bytes sind kein unterstütztes Bild oder Video.
`503`	Ein verfügbarer Decoder oder der C2PA-Verifier ist bei der Inferenz fehlgeschlagen. Die Antwort trägt einen `Retry-After`-Header.

Behandle 503 als vorübergehend und wiederhole die Anfrage nach dem Retry-After-Intervall. Ein Decoder, der schlicht nicht bereitgestellt ist, erzeugt nie einen 503 — er degradiert zu not_checked in einer normalen 200-Antwort.

​Request

​Response

​Das detected-Urteil

​Die Techniken im Detail

​Die metadata-Technik

​Wasserzeichen-Techniken

​Fehler

Request

Response

Das `detected`-Urteil

Die Techniken im Detail

Die `metadata`-Technik

Wasserzeichen-Techniken

Fehler