Kontoeinstellungen und API-Verhalten
Ein Teil des Verhaltens Ihres Kontos wird einmalig konfiguriert – größtenteils auf der Profileinstellungen-Seite der Web-App, eine Ausnahme (Modellstufe, weiter unten) nur durch das ImageToTable.ai-Team – und nicht über diese API. Diese Seite erklärt für jede dieser Einstellungen genau, wie sie sich in v1 auswirkt: ob die API sie bedingungslos übernimmt oder ob Sie sie pro Anfrage überschreiben können. Dies wird bewusst nicht über einzelne Endpunkt-Dokumentationen verteilt, sondern hier gebündelt, weil das übergreifende Verhalten leicht übersehen wird, wenn man nur die Referenzseite eines einzelnen Endpunkts liest.
Die allgemeine Regel
v1 liest die aktuelle Konfiguration Ihres Kontos direkt und wendet sie an – es gibt kein separates API-Konfigurationssystem und (mit einer bewussten Ausnahme, weiter unten) keine Möglichkeit, eine Kontoeinstellung für eine einzelne Anfrage zu überschreiben. Dies ist beabsichtigt: Zwei unabhängige Orte zur Konfiguration desselben Verhaltens (die Web-App und eine parallele API-Konfiguration) würden unweigerlich auseinanderdriften, und das Ziel ist, dass sich dasselbe Konto gleich verhält, egal welche Oberfläche – Web-App, diese API oder das Google Sheets Add-on – die Verarbeitung angestoßen hat.
Einstellungen und ihr API-Verhalten
| Einstellung | Verhalten in der Web-App | Verhalten in der v1-API | Pro Anfrage überschreibbar? |
|---|---|---|---|
bbox Auto-Annotationauto_annotate_bbox | Ein Schalter auf Kontoebene. Wenn aktiviert, löst jede abgeschlossene Extraktion automatisch einen kostenpflichtigen bbox-Annotationsdurchlauf aus. | Wird exakt befolgt — Batches, die über v1 erstellt und verarbeitet werden, folgen diesem Schalter ohne Ausnahme. Wenn er aktiviert ist, kann Ihnen die bbox-Annotation auch dann berechnet werden, wenn Sie POST /documents/{document_id}/bbox selbst nie aufrufen. | Nein. Es gibt keine Möglichkeit auf Anfrageebene, ihn zu überspringen oder zu erzwingen. |
Verarbeitungsqualitätthinking_type | Eine Einstellung auf Kontoebene, die eine Geschwindigkeits-/Qualitätsstufe für die Verarbeitung wählt. | Die eine Ausnahme von der obigen Regel. Wenn Sie quality bei POST /batches/{batch_name}/process weglassen, wird auf die aktuelle Einstellung Ihres Kontos zurückgegriffen — gleiches Verhalten wie in der Web-App. Sie können jedoch auch quality: "fast" oder quality: "high" bei dieser Anfrage übergeben, um sie nur für diesen Aufruf zu überschreiben. | Ja — die einzige Einstellung auf dieser Seite, die Sie pro Anfrage überschreiben können. |
Datenspeicherungauto_delete / auto_delete_after | Eine Einstellung auf Kontoebene zum automatischen Löschen von Originalbildern N Tage nach der Verarbeitung. | Wird exakt befolgt — Dokumente, die über v1 erstellt werden, unterliegen derselben Aufbewahrungsrichtlinie wie alles, was über die Web-App hochgeladen wird. | Nein. |
| Verarbeitungsmodus (intern rec_mode, angezeigt als mode) | Die Web-App unterstützt derzeit tabellarische Extraktion und Word-Konvertierung des gesamten Dokuments. | v1 unterstützt derzeit nur mode=table (strukturierte Feldextraktion). Die Konvertierung des gesamten Dokuments ist geplant, aber über die API noch nicht verfügbar. | Noch nicht anwendbar — es gibt nur einen Wert zur Auswahl. Wenn weitere Modi verfügbar werden, ist dies eine reine Ergänzung, keine Verhaltensänderung des bestehenden Werts. |
Modellstufemodel_tier | Welches KI-Modell für die Extraktionen eines Kontos verwendet wird und was jedes verarbeitete Dokument kostet: Standard (1 Credit, die Standardeinstellung für jedes Konto), Advanced (3 Credits) oder Premium (6 Credits). Wird vom ImageToTable.ai-Team zugewiesen — es gibt keinen Stufenwähler in den Kontoeinstellungen. | Wird exakt befolgt. POST /batches/{batch_name}/process zieht Credits zu dem Satz ab, den die aktuelle Stufe des Kontos kostet, ohne Möglichkeit, für einen einzelnen Aufruf eine andere Stufe anzufordern. Die Stufe wird in dem Moment festgelegt, in dem dieser Endpunkt aufgerufen wird — ein bereits in der Warteschlange befindliches Dokument behält die Stufe (und die Credit-Kosten), mit der es belastet wurde, auch wenn sich die Stufe des Kontos ändert, bevor dieses Dokument die Verarbeitung abschließt, und es wird zu derselben festgelegten Stufe erstattet, wenn es später storniert wird oder fehlschlägt. Siehe Kontonutzung für Informationen darüber, wie eine Nicht-Standard-Belastung im Credit-Ledger angezeigt wird. | Nein. Strenger als jede andere Zeile auf dieser Seite: Es ist nicht einmal eine Self-Service- Kontoeinstellung in der Web-App, daher gibt es nichts zu lesen und pro Anfrage zu spiegeln — v1 hat keinen Stufenparameter. |
Warum nicht einfach Überschreibungen auf Anfrageebene hinzufügen?
bbox Auto-Annotation und die Aufbewahrungsrichtlinie werden als Governance auf Kontoebene behandelt, nicht als Präferenzen pro Aufruf – sie sind die Art von „für alles an oder für alles aus“-Schalter, bei denen ein einzelner API-Aufruf, der stillschweigend von der bestehenden Kontokonfiguration abweicht, genau das Problem der zwei Konfigurationsquellen erzeugen würde, das dieses Design vermeidet. quality ist anders: Welche Geschwindigkeits-/Qualitätsstufe sinnvoll ist, kann tatsächlich von Aufruf zu Aufruf variieren (dieser Batch muss schnell raus, jener benötigt maximale Genauigkeit), daher wird es als betriebliche Entscheidung und nicht als Governance-Einstellung behandelt und als einzige Überschreibung geöffnet.
Modellstufe geht noch einen Schritt weiter als „keine Überschreibung pro Anfrage“ – sie ist nicht einmal eine Self-Service-Kontoeinstellung. Die anderen Zeilen auf dieser Seite sind Dinge, die Sie selbst auf der Profil-Einstellungsseite konfigurieren und die v1 einfach spiegelt; Modellstufe ist ein Tarif, den das ImageToTable.ai-Team basierend auf der tatsächlich ausgeführten Arbeitslast eines Kontos zuweist, da sie direkt ändert, was jedes Dokument kostet. Wenn man sie als etwas exponieren würde, das ein Aufrufer pro Anfrage (oder sogar pro Konto, ohne Unterstützung) umschalten könnte, könnte ein einziger fehlerhafter Wert die Rechnung eines Batches stillschweigend um das 3- oder 6-fache vervielfachen, ohne Bestätigungsschritt dazwischen – die Credits-sind-echtes-Geld-Version desselben Driftproblems, das der Rest dieser Seite vermeidet.