Leitfaden zur Migration der Pangram 3.0-API

Die Pangram 3.0-API ist jetzt verfügbar! In diesem Leitfaden erfahren Sie 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-gestützte Texte eingeführt. Texte, die in diese Kategorie fallen, werden in der Regel unter maßgeblicher Mitwirkung von KI und Menschen verfasst – was widerspiegelt, wie KI-Tools heute tatsächlich genutzt werden.

Wichtige Änderungen am Schema

Die v3-API klassifiziert jedes Dokument anhand von drei Bruchfeldern, die angeben, zu welchem Anteil das Dokument in die jeweilige Kategorie fällt:

• Bruchteil_Mensch — als von Menschen verfasst eingestufter Teil
• fraction_ai_assisted — als KI-gestützt eingestufter Teil
• fraction_ai — als KI-generiert eingestufter Teil

Diese drei Bereiche schließen sich gegenseitig aus und decken alle Möglichkeiten ab; ihre Summe ergibt immer 1.

Darüber hinaus enthält jedes Dokument drei Vorhersagezeichenfolgen mit unterschiedlicher Ausführlichkeit:

• Überschrift — z. B. „Vollständig von Menschen verfasst“, „KI-unterstützt“, „KI erkannt“
• Vorhersage — Ausführliche Erläuterung der Einstufung. Zum Beispiel: „Wir sind davon überzeugt, dass dieses Dokument vollständig von einer KI erstellt wurde“ oder „Wir gehen davon aus, dass dieses Dokument KI-gestützt, aber nicht vollständig von einer KI erstellt wurde“.
• kurze Vorhersage — z. B. „Mensch“, „Gemischt“, „KI“

Analyse auf Fensterebene

Jedes Eingabedokument wird in Fenster unterteilt. Jedes Fenster ist mit folgenden Angaben versehen:

• Bezeichnung — Klassifizierungszeichenfolge („Menschlich“, „teilweise KI-unterstützt“, „KI-generiert“ usw.)
• Vertrauen — Konfidenzwert aus Pangrams Erkennungsmodell („Hoch“, „Mittel“, „Niedrig“)
• ai_assistance_score — ein Skalarwert zwischen 0 und 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.

---

Sollte ich umziehen?

JA, wenn Sie:

• Pangram-Ergebnisse in einer Produktionsumgebung verwenden
• Möchten Sie die Genauigkeit der Ergebnisse der neuesten KI-Modelle verbessern?
• Planen Sie, die Pangram-API auch nach dem 1. April 2026 weiter zu nutzen

NEIN, wenn du:

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

---

Zeitleiste

---

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

Die folgenden v2-Endpunkte stehen während der Übergangsphase weiterhin zur Verfügung:

• 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, nutzen Sie die Felder der obersten Ebene:

Anpassung an das ursprüngliche Verhalten des Endpunkts: Der ursprüngliche Endpunkt verwendete für seine Vorhersage nur das erste Textfenster. Um dieses Verhalten nachzubilden:

Wichtig: Die Auslegung von ai_assistance_score unterscheidet sich von ai_wahrscheinlichkeit. Diese Felder sind nicht eins-zu-eins. Es ist mit mehr Vorhersagen im mittleren Bereich (0–1) zu rechnen. Verwenden Sie Bezeichnung um unsere empfohlene Auslegung 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 text.api.pangram.com die oben stehende Migrationsanleitung.

---

Von text-sliding.api.pangram.com

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

Änderungen am Fenster:

• In Textverschiebung, Fenster sind sich überlappend
• In Version 3 überlappen sich die Fenster nicht

---

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:

Geänderte Felder:

---

Dokumentation

Die vollständige API-Dokumentation finden Sie hier.

---

Fragen?

Wenn Sie Fragen zur Umstellung auf Version 3 haben, wenden Sie sich bitte an support@pangram.com.