> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inhaltsverifizierung

> Die kostenlose, nicht authentifizierte öffentliche API, um zu prüfen, ob ein Bild oder Video mit Samsa erstellt wurde.

<Info>
  Diese API ist **von der Samsa-REST-API getrennt**. Sie hat ihre eigene Basis-URL,
  verlangt keinen API-Key und verbraucht keine Credits — deshalb gilt keine der
  [Konventionen der API-Referenz](/de/api-reference/introduction) (Bearer-Auth, Scopes,
  Error-Envelope, Credit-Abrechnung) für sie.
</Info>

Samsa markiert seine KI-generierten Inhalte mit maschinenlesbaren Techniken, damit sie
später erkannt werden können. Mit dieser API liest du diese Markierungen wieder aus:
Lade ein Bild oder ein Video hoch, und sie meldet, was jede Technik gefunden hat.

Sie ist Samsas öffentlicher Erkennungsmechanismus nach **Artikel 50(2) des EU AI Act**
und für alle kostenlos nutzbar — Plattformen, Redaktionen, Forschende, Behörden oder
alle, die eine Datei haben und sie prüfen wollen.

## Basis-URL

```
https://detect.samsa.ai
```

Kein `Authorization`-Header, kein API-Key, keine Credits.

## Endpoints

| Endpoint                                                                        | Zweck                                                                           |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [`POST /v1/public/detect`](/de/content-verification/detect)                     | Ein hochgeladenes Bild oder Video prüfen.                                       |
| [`GET /v1/public/detect/info`](/de/content-verification/info)                   | Maschinenlesbare Beschreibung jeder Markierungstechnik und wie man sie erkennt. |
| [`GET /v1/public/detect/result/{request_id}`](/de/content-verification/results) | Signierte PDF eines früheren Ergebnisses.                                       |
| `GET /v1/public/detect/health`                                                  | Servicestatus und Version — siehe [Servicestatus](#servicestatus).              |

## Wie das Urteil zustande kommt

Die Antwort meldet jede Technik einzeln sowie ein `detected`-Gesamturteil. **Das Urteil
stammt aus der C2PA-Manifest-Prüfung**, die maßgeblich ist. Wasserzeichen-Techniken sind
nur Bestätigung: Sie können eine Zuordnung liefern, wenn kein Manifest vorhanden ist,
aber sie überschreiben das C2PA-Urteil nie.

| Technik                  | Rolle                             | Gilt für          | Gehostete Erkennung in der Samsa-API                                                                                                                                                                      |
| ------------------------ | --------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| C2PA Content Credentials | Maßgebliche Herkunftsebene        | Bilder und Videos | **Live.** Bereitgestellt von der öffentlichen Samsa-API und von jedem unabhängigen C2PA-Validator. Die Zuordnung eines Manifests zu Samsa wird verfügbar, sobald die Produktionssignierung aktiviert ist. |
| TrustMark Q              | Bild-Wasserzeichen · Bestätigung  | Bilder            | **Noch nicht verfügbar.** Die gehostete Wasserzeichen-Erkennung ist vor dem 2. Februar 2027 geplant.                                                                                                      |
| Meta Video Seal          | Video-Wasserzeichen · Bestätigung | Videos            | **Noch nicht verfügbar.** Die gehostete Wasserzeichen-Erkennung ist vor dem 2. Februar 2027 geplant.                                                                                                      |

<Warning>
  Da die gehostete Wasserzeichen-Erkennung noch nicht verfügbar ist, meldet die API
  beide Wasserzeichen-Techniken als `not_checked`, niemals als falsches „kein
  Wasserzeichen“. Eine `not_checked`-Technik wurde **nie ausgewertet** — das ist kein
  Befund, dass kein Wasserzeichen vorhanden ist. Siehe
  [Die Techniken im Detail](/de/content-verification/detect#die-techniken-im-detail).
</Warning>

<Card title="So funktioniert die Erkennung" icon="fingerprint" href="https://detect.samsa.ai/how-detection-works">
  Die kanonische Beschreibung je Technik: Algorithmus-IDs, Hashes der gepinnten
  Modell-Artefakte, die Soft-Binding-Label-Zuordnung je Signaturweg, Decoder und
  Vertrauensverankerung. Sie ist Samsas öffentliche Information nach Maßnahme 3.4(b)
  für die Europäische Kommission und weitere Interessengruppen. Denselben Inhalt gibt
  es als JSON über [`GET /v1/public/detect/info`](/de/content-verification/info).
</Card>

## Aufbewahrung

Uploads werden **im Arbeitsspeicher verarbeitet und niemals gespeichert**. Sie werden
weder persistiert noch geloggt. Erfasst wird nur ein Audit-Eintrag ohne Personenbezug —
eine Referenz der Anfrage, eine grobe Region und die Fakten zum Ergebnis. Wo eine
signierte Ergebnis-PDF ausgestellt wird, bleibt sie **24 Stunden** lang abrufbar.

## Servicestatus

`GET /v1/public/detect/health` liefert einen minimalen Status- und Versions-Payload. Der
Endpoint liest keine Client-Daten und gibt keine personenbezogenen Daten zurück — nutze
ihn für Uptime-Checks.

<CodeGroup>
  ```bash curl theme={null}
  curl https://detect.samsa.ai/v1/public/detect/health
  ```

  ```json Response theme={null}
  {
    "status": "healthy",
    "service": "daku-detect",
    "version": "0.1.0",
    "timestamp": "2026-07-25T06:32:42.089977+00:00"
  }
  ```
</CodeGroup>

## Fehler

Dieser Service verwendet **nicht** das [Error-Envelope](/de/guides/errors) der
Samsa-REST-API. Fehler kommen in der folgenden Form zurück, und du solltest anhand des
HTTP-Status verzweigen:

```json theme={null}
{
  "detail": "Unsupported media type: expected an image or video."
}
```

Ein `503` trägt zusätzlich einen `Retry-After`-Header. Die Statuscodes je Endpoint
stehen auf der jeweiligen Endpoint-Seite.

## Unabhängig prüfen

Du musst Samsa bei einem C2PA-Ergebnis nichts glauben. Das Manifest reist mit der Datei,
also liest jeder unabhängige Validator dieselben Belege.

<CardGroup cols={2}>
  <Card title="Content Credentials Verify" icon="badge-check" href="https://verify.contentauthenticity.org">
    Lade die Datei in den öffentlichen C2PA-Validator und sieh dir ihr Manifest selbst an.
  </Card>

  <Card title="Info-Endpoint" icon="code" href="/de/content-verification/info">
    Dieselbe Information je Technik als JSON, inklusive Decoder-Verweisen.
  </Card>
</CardGroup>
