API-Dokumentation

Senden Sie Ihren API-Schlüssel in einem der beiden akzeptierten Header. Beide sind absolut gleichwertig.

Authorization: Bearer nmd_live_xxxxxxxxxxxxxxxx
X-API-Key: nmd_live_xxxxxxxxxxxxxxxx

Schlüssel werden in Ihrem Dashboard generiert. Jeder Schlüssel wird nur ein einziges Mal angezeigt und als Hash gespeichert.

Liest jedes Metadatenfeld in der Datei aus und gibt ein normalisiertes Modell zurück.

curl -X POST https://your-domain/api/v1/analyze \
  -H "Authorization: Bearer $NMD_KEY" \
  -F "file=@photo.jpg"

Die Antwort gruppiert Felder nach Kategorien und bewahrt die ursprünglichen Rohwerte unter raw:

{
  "file": { "name": "photo.jpg", "format": "jpeg", "size": 4821904 },
  "counts": { "total": 31, "removable": 26, "sensitive": 16 },
  "blocks": { "exif": { "present": true, "count": 29 }, "gps": { "present": true } },
  "metadata": {
    "camera": {
      "camera.make": { "label": "Make", "value": "Apple", "sensitive": true, "removable": true }
    }
  }
}

Entfernt Metadaten und untersucht die erzeugten Bytes erneut, um das Resultat zu verifizieren. Gibt die bereinigte Datei oder den Prüfbericht als JSON mit <code>response=json</code> zurück.

curl -X POST https://your-domain/api/v1/clean \
  -H "Authorization: Bearer $NMD_KEY" \
  -F "file=@video.mp4" -F "mode=full" -OJ

removeC2pa ist standardmäßig deaktiviert. Eine normale Metadatenbereinigung entfernt C2PA-Credentials niemals ohne ausdrückliche Anforderung.

Beim Dateidownload reist im Header X-NoMoreData-Result eine URL-codierte Zusammenfassung des Verifizierungsberichts: die Skalarwerte wörtlich — verified ist nur true, wenn die erneute Analyse nichts Unerwartetes gefunden hat — und jede Liste als Anzahl, removedCount, residualCount und so weiter. Sie lässt sich immer decodieren und parsen. Für die Listen selbst response=json anfordern.

Wendet Änderungen auf bestimmte Felder an. Das Senden von <code>value: null</code> löscht das ausgewählte Feld.

replaceAll entfernt bestehende Metadatenblöcke, berührt jedoch keine C2PA-Content-Credentials, es sei denn, dies wird ausdrücklich angefordert.

curl -X POST https://your-domain/api/v1/edit \
  -H "Authorization: Bearer $NMD_KEY" \
  -F "file=@photo.jpg" \
  -F 'edits=[{"key":"camera.make","value":"Canon"},{"key":"location.latitude","value":null}]' \
  -F "response=json"

Wendet einen konsistenten Satz typischer Gerätemetadaten eines bestimmten Modells an.

curl -X POST https://your-domain/api/v1/apply-profile \
  -H "Authorization: Bearer $NMD_KEY" \
  -F "file=@photo.jpg" -F "profile=canon-eos-r5" -F "iso=400"

Das Anwenden eines Profils schreibt gerätetypische Metadaten, stellt jedoch keinen Rechtsbeweis dar, dass die Datei von diesem Gerät aufgenommen wurde.

JavaScript

const body = new FormData();
body.append('file', file);           // a File or Blob
body.append('mode', 'full');
body.append('response', 'json');

const res = await fetch('https://your-domain/api/v1/clean', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.NMD_KEY}` },
  body,
});

const report = await res.json();
console.log(report.verified, report.removed.length);

Python

import os, requests

with open("photo.jpg", "rb") as fh:
    response = requests.post(
        "https://your-domain/api/v1/clean",
        headers={"Authorization": f"Bearer {os.environ['NMD_KEY']}"},
        files={"file": fh},
        data={"mode": "full", "response": "json"},
    )

report = response.json()
print(report["verified"], len(report["removed"]))

Alle Fehler teilen eine einheitliche und vorhersehbare Struktur.

{ "error": { "code": "unsupported_format", "message": "GIF is not supported.", "hint": "..." } }

Es gelten zwei Kontrollen: ein IP-basiertes Ratenlimit zum Schutz des Dienstes und das monatliche vertragliche Kontingent Ihres Abonnements.

X-RateLimit-Limit: 2000
X-RateLimit-Remaining: 1834
X-RateLimit-Reset: 1767225600

Das Überschreiten des Kontingents liefert HTTP 429 mit dem Code quota_exceeded und einem Retry-After-Header zurück.

Das Anfordern einer nicht unterstützten Aktion liefert 422 unsupported_operation zurück.

Von /api/v1/edit akzeptierte Schlüssel.

An die API übermittelte Dateien werden während der Anfrage ausschließlich im flüchtigen Arbeitsspeicher verarbeitet und nach Auslieferung der Antwort unverzüglich verworfen.

Für maximale Vertraulichkeit bleibt die direkte Verarbeitung im Webbrowser der empfohlene Weg.