~/tools / Structured Output Schema Checker
Structured Output Schema Checker — Ein JSON Schema gegen die Grenzen von OpenAI, Anthropic und Gemini prüfen
Prüfen Sie ein JSON Schema gegen die dokumentierten Grenzen der Structured Outputs von OpenAI, Anthropic und Gemini. Sehen Sie, welche Schlüsselwörter abgelehnt, ignoriert oder nicht dokumentiert sind, bevor Sie das Schema an die API schicken. Nichts verlässt Ihren Browser.
Regeln am 2026-10-23 mit der Dokumentation des jeweiligen Anbieters abgeglichen.
Nicht geprüft: die Verschachtelungstiefe, das Limit für lange Enums und alles, was die Anbieter nicht dokumentieren. Die Anbieter ändern diese Regeln, gleichen Sie daher mit der aktuellen Dokumentation ab.
Alles läuft in Ihrem Browser. Das Schema wird nicht hochgeladen.
KI-APIs können die Antwort eines Modells auf ein JSON Schema festlegen, doch jeder Anbieter akzeptiert nur einen Teil von JSON Schema, und die Teile unterscheiden sich. Ein Schema, das bei einem Anbieter funktioniert, kann bei einem anderen abgelehnt werden oder akzeptiert werden, während einige seiner Regeln stillschweigend entfallen. Dieses Tool liest Ihr Schema und prüft es gegen das, was die Dokumentation des jeweiligen Anbieters festhält: Pflichtregeln wie additionalProperties mit dem Wert false, nicht unterstützte Schlüsselwörter, Schlüsselwörter, die zwar akzeptiert, aber nicht durchgesetzt werden, und veröffentlichte Größenlimits. Die Befunde sind in drei Arten eingeteilt, damit Sie einen dokumentierten Fehler von einem Schlüsselwort unterscheiden können, das die Dokumentation schlicht nicht aufführt. Die Regeln wurden an dem Datum, das unter dem Tool steht, mit der Dokumentation der Anbieter abgeglichen.
Anwendungsfälle
- Ein Schema prüfen, bevor Sie es als Structured-Output-Anfrage senden, damit Sie nicht erst durch einen 400-Fehler davon erfahren
- Herausfinden, welche Schlüsselwörter Sie aus dem Schema entfernen und in Ihren eigenen Validierungscode verlagern müssen
- Vergleichen, was OpenAI, Anthropic und Gemini jeweils für dasselbe Schema akzeptieren
Verwendung
- Fügen Sie das JSON Schema ein, das Sie senden möchten, oder laden Sie das Beispiel.
- Lesen Sie das Ergebnis für jeden Anbieter. Nicht akzeptiert bedeutet: Laut Dokumentation schlägt das Schema fehl oder muss geändert werden. Ignoriert bedeutet: Das Schlüsselwort wird akzeptiert, aber nicht durchgesetzt. Nicht dokumentiert bedeutet: Das Schlüsselwort fehlt in der Liste der unterstützten Schlüsselwörter des Anbieters.
- Beheben Sie, was als Nicht akzeptiert markiert ist, und prüfen Sie den Rest mit einer echten Anfrage.
FAQ
Heißt ein sauberes Ergebnis, dass die API mein Schema akzeptiert?
Nein. Das Tool prüft die Regeln, die die Anbieter dokumentieren. Es ruft keine API auf, und die Dokumentation deckt nicht alles ab, daher kann ein Schema trotzdem abgelehnt werden. Verstehen Sie ein sauberes Ergebnis als „kein bekanntes Problem“ und testen Sie mit einer echten Anfrage.
Was bedeuten Nicht akzeptiert, Ignoriert und Nicht dokumentiert?
Nicht akzeptiert: Laut Dokumentation wird das Schlüsselwort nicht unterstützt oder es muss eine Regel eingehalten werden, zum Beispiel muss additionalProperties den Wert false haben. Ignoriert: Laut Dokumentation wird das Schlüsselwort akzeptiert, aber nicht durchgesetzt, das Modell kann es also verletzen. Nicht dokumentiert: Das Schlüsselwort steht nicht in der Liste der unterstützten Schlüsselwörter des Anbieters, es kann also abgelehnt oder ignoriert werden, und die Dokumentation sagt nicht, was davon.
Warum verlangt OpenAI, dass jede Property required ist?
Im Strict-Modus verlangt OpenAI, dass alle Properties in required aufgeführt sind und additionalProperties den Wert false hat. Um ein Feld optional zu machen, empfiehlt die Dokumentation eine Union mit null, zum Beispiel den type ["string", "null"].
Mein Schema verwendet minimum, maxLength oder Ähnliches. Was soll ich tun?
Anthropic unterstützt keine numerischen Einschränkungen und keine Längenlimits für Strings, und Gemini setzt Längenlimits nicht durch. Entfernen Sie sie aus dem Schema, beschreiben Sie die Grenze im Feld description und prüfen Sie den Wert selbst, nachdem die Antwort eingetroffen ist. Das Tool JSON Schema Validator kann diese Prüfung übernehmen.
Prüft dieses Tool Rekursion?
Ja, bei Anthropic, dessen Dokumentation rekursive Schemas als nicht unterstützt aufführt. OpenAI und Gemini dokumentieren rekursive Schemas, sie werden daher nicht beanstandet.
Was wird nicht geprüft?
Die Verschachtelungstiefe, das Limit für lange Enums und alles, was die Anbieter nicht dokumentieren. Das Tool kennt außerdem keine neueren Modelle oder Funktionen, die nach dem Prüfdatum hinzugekommen sind. Gleichen Sie daher bei Bedarf mit der aktuellen Dokumentation ab.
Wird mein Schema an einen Server gesendet?
Nein. Die Prüfung läuft in Ihrem Browser.