Mit der Content Provenance API kannst du prüfen, ob eine Bild- oder Audiodatei unterstützte Herkunftssignale von OpenAI enthält. Sende eine Datei an POST /v1/content_provenance_checks. Du erhältst die Ergebnisse der abgeschlossenen Prüfung in derselben Antwort. Du kannst diese Signale bei der Prüfung und Kennzeichnung von Inhalten, bei Faktenchecks und in Arbeitsabläufen im Bereich Trust and Safety nutzen.
Wenn du eine Datei im Browser prüfen möchtest, nutze das Webtool auf openai.com/verify.
Die Anfrageparameter und Antwortschemas findest du in der Referenz zur Content Provenance API.
Wenn du Texte prüfen möchtest, beantrage den Zugang. Die Textprüfung steht derzeit nur zugelassenen Organisationen zur Verfügung, darunter Einrichtungen der KI-Forschung und wissenschaftliche Einrichtungen. OpenAI prüft jeden Antrag einzeln.
Das Ergebnis not_detected bedeutet, dass das Tool in der hochgeladenen Datei keine unterstützten Signale gefunden hat. Der Inhalt kann dennoch mit OpenAI generiert worden sein. Möglicherweise wurden die Metadaten entfernt, sie weisen Anzeichen einer Manipulation auf oder das Wasserzeichen wurde abgeschwächt. Der Inhalt kann auch von einem älteren generativen Modell stammen oder entstanden sein, bevor Herkunftssignale verfügbar waren. Das Tool erkennt derzeit keine Inhalte, die mit dem KI-Modell eines anderen Unternehmens generiert wurden. Auch diese Möglichkeit schließt das Ergebnis not_detected daher nicht aus.
Welche Herkunftssignale die API prüft
Die API prüft unterstützte Dateien auf folgende Signale:
| Signal | Dateitypen | Gegenstand der Prüfung |
|---|---|---|
| C2PA Content Credentials | Bilder | Signierte Metadaten mit Angaben zur ausstellenden Stelle und zum Einsatz von KI |
| SynthID | Bilder und Audiodateien | Ein Wasserzeichen, das direkt in die unterstützten Medien eingebettet ist |
C2PA-Metadaten liefern weitere Informationen zur Herkunft einer Datei. Beim Bearbeiten, Konvertieren oder Teilen der Datei können diese Metadaten verloren gehen. Ein SynthID-Wasserzeichen ist Bestandteil des Bildes oder des Audiosignals selbst und kann bei bestimmten Veränderungen erhalten bleiben.
Die API prüft auf unterstützte Signale von OpenAI. Sie eignet sich nicht als universeller KI-Detektor und kann nicht die Inhalte jedes KI-Systems erkennen. Sichtbare Wasserzeichen und Kennzeichnungen sind von den Herkunftssignalen zu unterscheiden, die die API prüft.
Eine Datei prüfen
Sende mit dem OpenAI SDK eine Bild- oder Audiodatei im Feld file. Das SDK erstellt die Multipart-Anfrage und liest deinen API-Schlüssel aus der Umgebungsvariablen OPENAI_API_KEY:
import { createReadStream } from "node:fs";
import OpenAI, { toStreamingFile } from "openai";
const client = new OpenAI();
const result = await client.contentProvenanceChecks.create({
file: toStreamingFile(createReadStream("myimage.png"), "myimage.png", {
type: "image/png",
}),
});
console.log(result);Verwende das OpenAI SDK mindestens in der jeweils angegebenen Version: Python 2.52.0, Go 3.49.0 und Ruby 0.75.0.
Für Audiodateien im Opus-Format verwendest du denselben Endpunkt. Setze den Medientyp der hochgeladenen Datei auf audio/ogg:
curl https://api.openai.com/v1/content_provenance_checks \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-F "file=@./example.opus;type=audio/ogg"
Die Antwort enthält das Ergebnis der abgeschlossenen Prüfung. Für ein Bild kann sie beispielsweise so aussehen:
{
"object": "content_provenance_check",
"created_at": 1778000000,
"results": [
{
"type": "c2pa",
"outcome": "detected",
"validation_state": "trusted",
"issuer": "OpenAI OpCo, LLC",
"model": "gpt-image",
"generated_at": "2026-07-27T18:34:12Z"
},
{
"type": "synthid",
"outcome": "not_detected",
"model": null,
"generated_at": null
}
]
}
Das Feld object gibt den Antworttyp an. created_at gibt als Unix-Zeitstempel in Sekunden an, wann die Prüfung erstellt wurde. Welche Einträge results enthält, hängt von der hochgeladenen Datei ab: Bei Bildern enthält die Antwort Ergebnisse für C2PA und SynthID, bei Audiodateien ein Ergebnis für SynthID. Die API lässt nicht anwendbare Prüfungen aus, anstatt not_detected zurückzugeben.
Die API schließt die Prüfung ab, bevor sie antwortet. Du musst weder einen Hintergrundjob erstellen noch einen anderen Endpunkt wiederholt abfragen oder die Datei über die Files API hochladen.
Wenn eine Anfrage fehlschlägt, prüfe den HTTP-Status und, sofern verfügbar, error.code. Bei einer fehlerhaften, nicht unterstützten oder blockierten Datei gibt die API 400 zurück. Eine Organisation ohne Zugriff erhält 404. Überschreitet eine Anfrage das Ratenlimit, gibt die API 429 zurück. Wiederhole die Anfrage nur bei vorübergehenden Fehlern, etwa wenn du das Ratenlimit erreicht hast oder ein Serverfehler auftritt. Allgemeine Hinweise findest du im Leitfaden zu API-Fehlercodes.
Prüfergebnisse verstehen
Werte jeden zutreffenden Eintrag in results einzeln aus. Bei Bildern enthält die Antwort Einträge für C2PA und SynthID, bei Audiodateien einen Eintrag für SynthID. Auf der obersten Ebene der Antwort gibt es kein Feld outcome.
C2PA-Ergebnisse
Ein C2PA-Ergebnis beschreibt den Status der Content Credentials eines Bildes:
{
"type": "c2pa",
"outcome": "detected",
"validation_state": "trusted",
"issuer": "OpenAI OpCo, LLC",
"model": "gpt-image",
"generated_at": "2026-07-27T18:34:12Z"
}
Die Felder haben folgende Bedeutung:
outcomegibt an, ob die API von OpenAI ausgestellte Nachweise für die Generierung mit KI erkannt hat (detected) oder nicht (not_detected).validation_stategibt den Status des Manifests an:trusted,valid,invalidodernot_present.issuergibt an, wer das Manifest ausgestellt hat, sofern diese Information vorliegt.modelgibt an, welches Modell den Inhalt generiert hat, sofern diese Information vorliegt.generated_atgibt an, wann der Inhalt generiert wurde, sofern diese Information vorliegt.
Das Ergebnis lautet nur dann detected, wenn ein Manifest mit dem Status trusted oder valid OpenAI als ausstellende Stelle nennt und eine Aktion zur Generierung mit KI enthält. Stammt das Manifest von einem Drittanbieter, fehlt die Aktion zur Generierung mit KI oder lautet der Status invalid oder not_present, ist das Ergebnis not_detected. Die Felder issuer und validation_state können auch dann Angaben zum Manifest enthalten, wenn das Ergebnis not_detected lautet.
Verwende ein Manifest mit dem Status invalid nicht als verlässlichen Herkunftsnachweis. Das Ergebnis not_present bedeutet, dass für das Bild kein C2PA-Manifest verfügbar ist.
SynthID-Ergebnisse
Ein SynthID-Ergebnis gibt an, ob das Prüftool ein unterstütztes Wasserzeichen in einer Bild- oder Audiodatei erkannt hat:
{
"type": "synthid",
"outcome": "detected",
"model": null,
"generated_at": null
}
Das Ergebnis detected bedeutet, dass das Prüftool ein bekanntes Wasserzeichen in der Datei erkannt hat. Das Ergebnis not_detected bedeutet, dass das Prüftool dieses Wasserzeichen nicht erkannt hat. Der Inhalt kann dennoch mit KI generiert oder verändert worden sein. Die Felder model und generated_at geben an, welches Modell den Inhalt generiert hat und wann er generiert wurde, sofern diese Informationen vorliegen. Beide Felder können jeweils den Wert null haben.
Unterstützte Uploads
Standardmäßig unterstützt die API folgende Dateiformate:
- Bilder: PNG, JPEG, WebP und GIF.
- Audio: MP3, Opus, AAC, FLAC, WAV und PCM.
Jede hochgeladene Datei darf höchstens 50 MiB groß sein. Audiodateien dürfen nach dem Dekodieren höchstens 60 Sekunden lang sein.
Gib den Medientyp für den Teil der Multipart-Anfrage an, der die hochgeladene Datei (file) enthält. Verwende image/gif für GIF-Dateien, image/png für PNG-Bilder oder audio/ogg für Opus-Audiodateien. Füge kein separates Feld type hinzu und setze den Anfrageheader für multipart/form-data nicht manuell. Bei curl legt die Option -F den Inhaltstyp der Anfrage und die Multipart-Trennzeichenfolge fest. Sende pro Anfrage eine Datei.
Ratenlimits
Strenge Ratenlimits helfen, die API vor Missbrauch zu schützen. Organisationen können höhere Ratenlimits beantragen. OpenAI prüft jeden Antrag einzeln.
Wenn die API 429 rate_limit_exceeded zurückgibt, sende weniger Anfragen pro Zeiteinheit. Halte dich an die Angabe im Header Retry-After, sofern er vorhanden ist. Allgemeine Hinweise zum Wiederholen von Anfragen findest du im Leitfaden zu Ratenlimits.
Prüfergebnisse verantwortungsvoll nutzen
Nutze die Prüfergebnisse als Belege im Rahmen einer umfassenderen Prüfung:
detectedbelegt, dass ein bestimmtes unterstütztes Signal vorliegt. Die vollständige Entstehungs- und Bearbeitungsgeschichte der Datei lässt sich daraus nicht ablesen.not_detectedbedeutet, dass kein unterstütztes Signal erkannt wurde. Daraus folgt weder, dass ein Mensch den Inhalt erstellt hat, noch, dass er ohne OpenAI generiert wurde.- Prüfe, wer das C2PA-Manifest ausgestellt hat, bevor du ein Bild einem bestimmten Anbieter zuschreibst.
- Prüfe nach Möglichkeit die Originaldatei. Komprimierung, Zuschneiden, Screenshots, das Entfernen von Metadaten und Formatkonvertierungen können ein Signal abschwächen oder ganz beseitigen.
- Berücksichtige, mit welchem Produkt und Modell der Inhalt erstellt wurde, in welchem Dateiformat er vorliegt und wann er entstanden ist. Nicht alle mit OpenAI generierten Inhalte enthalten ein unterstütztes Signal.
- Lass automatisierte Entscheidungen in Arbeitsabläufen mit weitreichenden Folgen zusätzlich von Menschen überprüfen.
- Nutze wiederholte Abfragen nicht, um die Funktionsweise eines Wasserzeichens zu rekonstruieren, es zu entfernen oder seine Erkennung zu umgehen.
- Ziehe aus einem Prüfergebnis keine Rückschlüsse auf den Prompt, das Konto oder die Person, die den Inhalt erstellt hat.
Für die Nutzung der Content Provenance API gilt das OpenAI Services Agreement.
Informationen zu den plattformweiten Einstellungen für die Überwachung und Aufbewahrung von Daten findest du im Leitfaden zu Datenkontrollen.