JSON in Zod-Schema umwandeln
JSON in Zod-Schema umwandeln: Aus einem Beispielobjekt entsteht ein Zod-Schema mit z.object, optionalen Feldern, Formaten und z.infer-Typ für Zod 3 oder Zod 4.
Alles läuft in Ihrem Browser. Eingaben verlassen Ihr Gerät nicht.
Zod-Schemas aus Beispieldaten
Mit diesem Werkzeug wandeln Sie JSON in ein Zod-Schema um. Zod ist eine verbreitete TypeScript-Bibliothek, die Daten zur Laufzeit prüft und gleichzeitig den passenden Typ liefert. Aus einem JSON-Beispiel entsteht Code mit z.object, z.array, z.string und Co.; mit z.infer leiten Sie daraus den TypeScript-Typ ab. Das ist TypeScript-Validierung ohne doppelte Pflege von Interface und Prüfcode.
Wenn Sie ein Array von Objekten einfügen, führt das Werkzeug alle Einträge zusammen: Felder, die nicht überall vorkommen, werden optional, unterschiedliche Typen werden zu einer Union. Ganze Zahlen erhalten .int(), Werte null machen ein Feld .nullable(). Mit der Formaterkennung werden E-Mail-Adressen, URLs, UUIDs und ISO-Zeitstempel erkannt. In Zod 4 heißen diese Prüfungen z.email(), z.url(), z.uuid() und z.iso.datetime(), in Zod 3 z.string().email() und so weiter; beide Schreibweisen stehen zur Wahl. So lässt sich ein Zod-Schema generieren, das zu Ihrem Projekt passt.
Besonders nützlich ist das bei KI-Anwendungen: Antworten mit strukturierter Ausgabe sollten vor der Weiterverarbeitung geprüft werden, und viele SDKs nehmen Zod-Schemas direkt als Format entgegen. Grenzen: Ein Beispiel zeigt nur, welche Werte vorkommen, nicht welche erlaubt sind. Ergänzen Sie Enums, Längen und Wertebereiche von Hand. Interfaces und Pydantic-Modelle erzeugt JSON in TypeScript, ein JSON Schema der JSON-Schema-Generator.
Anleitung: JSON in Zod-Schema in 4 Schritten
- Ein oder mehrere Beispielobjekte in das Feld „JSON-Beispiel“ einfügen; bei einem Array werden alle Einträge zusammengeführt.
- Im Feld „Name des Schemas“ den Namen für die Konstante festlegen.
- Unter „Zod-Version“ zwischen Zod 3 und Zod 4 wählen und Formaterkennung sowie
.strict()einstellen. - Den erzeugten Code mit „Kopieren“ in Ihr TypeScript-Projekt übernehmen.
Typische Anwendungsfälle
- Antworten eines Sprachmodells mit strukturierter Ausgabe zur Laufzeit prüfen, bevor die Anwendung sie nutzt.
- Für eine fremde REST-API schnell ein Schema aus einer Beispielantwort erzeugen.
- Formulardaten oder Konfigurationsdateien in einem Node-Projekt validieren.
- Ein vorhandenes Interface durch ein Zod-Schema ersetzen und den Typ mit
z.inferableiten.
Häufige Fragen
Was ist der Unterschied zwischen Zod 3 und Zod 4?
Zod 4 bietet Formate als eigene Funktionen wie z.email() und z.iso.datetime(). Die Schreibweise z.string().email() funktioniert dort weiter, gilt aber als veraltet.
Warum wird aus 1.5 und 2 nur z.number()?
Sobald ein Wert eine Nachkommastelle hat, verzichtet das Werkzeug auf .int(). Sind alle Werte ganzzahlig, wird .int() angehängt.
Wie werden leere Arrays behandelt?
Ein leeres Array liefert keine Information über seine Elemente. Es wird zu z.array(z.unknown()), das Sie anschließend genauer fassen sollten.
Brauche ich eine Installation?
Für den erzeugten Code brauchen Sie das Paket zod in Ihrem Projekt, etwa mit npm install zod. Das Werkzeug selbst läuft ohne Installation im Browser.
Woran erkennt das Werkzeug optionale Felder?
Enthält das Beispiel ein Array von Objekten, wird jedes Feld, das nicht in allen Objekten vorkommt, mit .optional() versehen. Felder mit dem Wert null erhalten .nullable().
Funktioniert das Schema mit dem Vercel AI SDK oder OpenAI-Helfern?
Diese Bibliotheken nehmen Zod-Schemas entgegen. Für strukturierte Ausgaben verlangen manche Anbieter, dass alle Felder Pflichtfelder sind; prüfen Sie dann optionale Felder im erzeugten Schema.
Zum Weiterlesen
- RAG einfach erklärt: KI mit eigenen Dokumenten nutzenRAG einfach erklärt: wie Retrieval-Augmented Generation funktioniert, wofür man Embeddings und Vektordatenbanken braucht und was ein RAG-System kostet.
- Structured Outputs: Zuverlässig JSON von KI-ModellenStructured Outputs erklärt: Wie Sie mit JSON-Schema garantiert gültiges JSON von OpenAI, Claude und Gemini bekommen, statt kaputte Antworten nachträglich zu reparieren.
- Prompt Injection: Wie Angriffe auf KI-Systeme funktionierenPrompt Injection erklärt: wie versteckte Anweisungen in E-Mails, Dokumenten und Websites KI-Assistenten und Agenten manipulieren und welche Schutzmaßnahmen wirken.
Das könnte auch helfen
JSON formatierenneu
JSON formatieren, prüfen und minifizieren, mit Fehlerstelle und Tokenzahl.
ÖffnenJSON reparierenneu
Kaputtes JSON aus KI-Antworten reparieren: Codeblöcke, Kommas, Anführungszeichen.
ÖffnenBatch-Datei-Generatorneu
Aus einer Vorlage und einer Liste viele Prompts erzeugen, als JSONL für die Batch-APIs.
ÖffnenAPI-Anfrage-Generatorneu
Fertige cURL-Anfragen für die APIs von OpenAI, Anthropic und Google erzeugen.
ÖffnenPrompt-Injection-Prüferneu
Fremde Texte vor der KI-Verarbeitung auf versteckte Anweisungen und Tricks prüfen.
ÖffnenJSON-Schema-Generator
Aus einem JSON-Beispiel ein JSON Schema für strukturierte Ausgaben von KI-Modellen erzeugen.
Öffnen