Pangram 3.0 API-Migrationshandbuch

Die Pangram 3.0 API ist live! Dieser Leitfaden enthält alles, was Sie über die Migration von unseren v2-Endpunkten zur neuen v3-API wissen müssen.

Was ist neu in Version 3?

Wir haben eine dritte Klassifizierungskategorie für KI-unterstützte Texte eingeführt. Texte, die in diese Kategorie fallen, werden in der Regel mit erheblichem KI- und menschlichem Input verfasst – was widerspiegelt, wie Menschen KI-Tools heute tatsächlich nutzen.

Wichtige Schemaänderungen

Die v3-API klassifiziert jedes Dokument anhand von drei Bruchteilsfeldern, die angeben, wie viel Prozent des Dokuments in jede Kategorie fallen:

• Fraktion Mensch — als von Menschen verfasst eingestufter Teil
• fraktioniert_ai_unterstützt — als KI-unterstützt eingestufter Teil
• fraktion_ai — als KI-generiert klassifizierter Teil

Diese drei Felder schließen sich gegenseitig aus und sind zusammen vollständig; ihre Summe ergibt immer 1.

Darüber hinaus enthält jedes Dokument drei Vorhersagestrings mit unterschiedlichen Ausführlichkeitsstufen:

• Überschrift — z. B. „Vollständig von Menschen geschrieben“, „KI-unterstützt“, „KI-erkannt“
• Vorhersage — Detaillierte Erläuterung der Klassifizierung. Zum Beispiel: „Wir sind überzeugt, dass dieses Dokument vollständig KI-generiert ist“ oder „Wir glauben, dass dieses Dokument KI-unterstützt, aber nicht vollständig KI-generiert ist“.
• Vorhersage_kurz — z. B. „Mensch“, „Gemischt“, „KI“

Fenster-Level-Analyse

Jedes Eingabedokument wird in Fenster unterteilt. Jedes Fenster ist gekennzeichnet mit:

• Etikett — Klassifizierungszeichenfolge („Menschlich“, „Mäßig KI-unterstützt“, „KI-generiert“ usw.)
• Selbstvertrauen — Konfidenzausgabe aus dem Erkennungsmodell von Pangram („Hoch“, „Mittel“, „Niedrig“)
• KI-Unterstützungswert — Skalarwert von 0 bis 1, der den Umfang der KI-Unterstützung angibt

Hinweis: In naher Zukunft werden voraussichtlich weitere Kennzeichnungen („leicht KI-unterstützt“, „stark KI-unterstützt“) eingeführt.

---

Soll ich migrieren?

JA, wenn Sie:

• Verwendung von Pangram-Ergebnissen in einer Produktionsumgebung
• Sie möchten eine verbesserte Genauigkeit bei den Ergebnissen der neuesten KI-Modelle.
• Planen Sie, die Pangram-API über den 1. April 2026 hinaus zu nutzen.

NEIN, wenn Sie:

• Sind Sie ein Forscher, der eine statische API für Reproduzierbarkeit benötigt?

---

Zeitachse

Datum	Veranstaltung
11. Dezember 2025	Pangram 3.0 über das Dashboard veröffentlicht
23. Dezember 2025	Pangram 3.0 über die API verfügbar
Ende Januar 2026	Pangram 3.1 veröffentlicht (Dashboard + API). Alle Nutzer der API 3.0 wurden automatisch aktualisiert.
1. April 2026	Pangram 2.0 APIs werden eingestellt

---

V2-Endpunkte (verfügbar bis zum 1. April 2026)

Die folgenden v2-Endpunkte bleiben während der Übergangsphase verfügbar:

• text.api.pangram.com
• text-batch.api.pangram.com
• text-sliding.api.pangram.com
• text-extended.api.pangram.com
• Dashboard-Text.api.pangram.com

---

Leitfaden zur Feldmigration

Von text.api.pangram.com

Endpunkt: https://text.api.pangram.com → https://text.api.pangram.com/v3

Um Pangrams Vorhersagen bestmöglich zu verstehen, verwenden Sie die Felder der obersten Ebene:

v2 Feld	v3 Feld	Anmerkungen
Vorhersage	Überschrift	Werte wie „vollständig von Menschen geschrieben“, „KI-unterstützt“, „KI-erkannt“
ai_Wahrscheinlichkeit	fraktion_ai	Menge des Textes, der vermutlich von KI generiert wurde
—	fraktioniert_ai_unterstützt	Neu: Menge vermutlich KI-gestützt
—	Fraktion Mensch	Menge, die vermutlich von Menschen geschrieben wurde

Anpassung an das ursprüngliche Endpunktverhalten: Der ursprüngliche Endpunkt verwendete nur das erste Fenster des Textes, um seine Vorhersage zu treffen. Um dieses Verhalten anzupassen:

v2 Feld	v3 Feld
Vorhersage	Fenster[0].Bezeichnung und windows[0].Vertrauenswürdigkeit
ai_Wahrscheinlichkeit	windows[0].ai_assistance_score

Wichtig: Die Interpretation von KI-Unterstützungswert unterscheidet sich von ai_WahrscheinlichkeitDiese Felder sind nicht eins zu eins. Es sind mehr Vorhersagen im mittleren Bereich (0–1) zu erwarten. Verwenden Sie Etikett um unsere empfohlene Interpretation zu verstehen.

---

Von text-batch.api.pangram.com

Derzeit gibt es keinen Batch-Endpunkt für die v3-API. Verwenden Sie eine Schleife, um jedes Element einzeln zu verarbeiten, indem Sie den folgenden Schritten folgen: text.api.pangram.com Migrationsanleitung oben.

---

Von text-sliding.api.pangram.com

Endpunkt: https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3

v2 Feld	v3 Feld	Anmerkungen
Vorhersage	Überschrift oder Vorhersage	Verschiedene Ausführlichkeitsstufen verfügbar
Vorhersage_kurz	Vorhersage_kurz	Unverändert
ai_Wahrscheinlichkeit, Durchschnittliche Wahrscheinlichkeit der künstlichen Intelligenz	fraktion_ai, fraktioniert_ai_unterstützt, Fraktion Mensch	Verwenden Sie Mengenfelder anstelle von aggregierten Konfidenzwerten.
max_ai_Wahrscheinlichkeit	fraktion_ai (empfohlen)	Mengenfelder bevorzugt

Fensteränderungen:

• In TextverschiebungFenster sind überlappend
• In Version 3 überlappen sich Fenster nicht.

v2 Fensterfeld	v3 Fensterfeld
windows[].Vorhersage	windows[].label + windows[].Vertrauenswürdigkeit
windows[].ai_wahrscheinlichkeit	windows[].ai_assistance_score

---

Von text-extended.api.pangram.com

Endpunkt: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3

Die meisten Felder bleiben unverändert:

Feld	Status
Überschrift	Unverändert
Vorhersage	Unverändert
Vorhersage_kurz	Unverändert
Fraktion Mensch	Unverändert
fraktion_ai	Unverändert
windows[].label	Unverändert
windows[].Vertrauenswürdigkeit	Unverändert
windows[].start_index	Unverändert
windows[].end_index	Unverändert

Geänderte Felder:

v2 Feld	v3 Feld	Anmerkungen
gemischte Bruchzahl	fraktioniert_ai_unterstützt	Feld zur besseren Übersichtlichkeit umbenannt
Armaturenbrett	öffentlicher_Dashboard-Link	Feld zur besseren Übersichtlichkeit umbenannt
Durchschnittliche Wahrscheinlichkeit der künstlichen Intelligenz	fraktion_ai, fraktioniert_ai_unterstützt, Fraktion Mensch	Verwenden Sie Mengenfelder anstelle von aggregierten Konfidenzwerten.
max_ai_Wahrscheinlichkeit	fraktion_ai, fraktioniert_ai_unterstützt, Fraktion Mensch	Verwenden Sie Mengenfelder anstelle von aggregierten Konfidenzwerten.
windows[].ai_wahrscheinlichkeit	windows[].ai_assistance_score	Die AI-Wahrscheinlichkeit und die AI-Unterstützungswerte sind nicht eins zu eins. Verwendung Etikett als Orientierungshilfe.

---

Dokumentation

Die vollständige API-Dokumentation finden Sie hier.

---

Fragen?

Wenn Sie Fragen zur Migration auf v3 haben, wenden Sie sich bitte an support@pangram.com.