GLiDE-Inferenz mit /v1/systemone

POST https://api.fastino.ai/v1/systemone

Dies ist der Inferenzendpunkt für GLiDE. Senden Sie einen nicht leeren state und eine oder mehrere benannte, typisierte questions; lesen Sie strukturierte Entscheidungen aus answers. GLiDE verwendet weder /v1/chat/completions noch messages oder ein GLiNER-schema.

Ihren API-Schlüssel einrichten

Erstellen Sie ein Fastino-Konto
Rufen Sie Ihren API-Schlüssel unter Settings ab

Setzen Sie Ihren Schlüssel als Umgebungsvariable, damit die folgenden Beispiele unverändert funktionieren:

export FASTINO_API_KEY="your_api_key_here"

setx FASTINO_API_KEY "your_api_key_here"

Einen Fragetyp wählen

Jede Frage ist Single-Label und gibt Wahrscheinlichkeiten zurück. Wählen Sie das Primitiv anhand der Antwortform, die Ihr Code benötigt:

Primitiv	Verwenden, wenn	`criteria`-Form	Primäres Ergebnis
Noul	Die Antwort Ja oder Nein lautet	Optional `{"true": "...", "false": "..."}`; Standard ist Yes/No	`noul`, die Wahrscheinlichkeit für true
Choice	Genau eine ungeordnete Option gewinnen soll	Objekt, das Optionsschlüssel auf Beschreibungen abbildet	`choice` plus `probabilities`
Score	Die Antwort auf eine geordnete Skala gehört	Geordnetes Array von Stufenbeschreibungen	`score`, `expected_level` und `probabilities`

Es gibt kein Multi-Label-Primitiv. Stellen Sie mehrere unabhängig benannte Fragen in einer Anfrage, wenn Sie mehrere Urteile über denselben State benötigen.

Anfrage

string

erforderlich

Verwenden Sie fastino/GLiDE. Die Antwort gibt den Engine-Namen als glide zurück.

string | object | array

erforderlich

Die nicht leere Situation, die bewertet werden soll. Verwenden Sie einen String für eine Passage, ein Objekt für beschriftete Felder oder ein Array für eine geordnete Abfolge von Nachrichten oder Datensätzen.

object

erforderlich

Ein nicht leeres Objekt mit von Ihnen gewählten Namen als Schlüsseln. Jeder Wert muss type und instructions enthalten; Choice und Score erfordern zusätzlich criteria. Dieselben Schlüssel erscheinen unter answers in der Antwort.

Vollständige Anfrage

curl --max-time 300 -s https://api.fastino.ai/v1/systemone \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fastino/GLiDE",
    "state": "Refund request: the receipt is attached, the purchase was 10 days ago, and refunds are allowed within 30 days.",
    "questions": {
      "refund_allowed": {
        "type": "noul",
        "instructions": "Does this request qualify for a refund?",
        "criteria": { "true": "Qualifies", "false": "Does not qualify" }
      }
    }
  }'

Antwort

{
  "model": "glide",
  "answers": {
    "refund_allowed": {
      "type": "noul",
      "noul": 0.99767683794902,
      "confidence": 0.9953536758980399
    }
  },
  "usage": { "input_tokens": 89, "output_tokens": 1 }
}

answers verwendet die Fragenschlüssel aus Ihrer Anfrage. Für dieses Noul gilt:

noul ist die Wahrscheinlichkeit, dass das true-Kriterium zutrifft. Es ist kein boolescher Wert.
confidence ist die Sicherheit bezüglich eines der beiden Ergebnisse: |2 × noul − 1|.
Passen Sie die Schwellenwerte für Aktionen anhand repräsentativer Daten an. Gehen Sie nicht davon aus, dass 0.5 der richtige geschäftliche Schwellenwert ist.

Choice und Score geben andere Felder zurück. Die genauen Antwortformen und Integrationsbeispiele finden Sie auf den jeweiligen Primitiv-Seiten.

Limits und nicht unterstützte Formen

Jeder gerenderte Frage-Prompt (state plus die jeweilige Frage) muss in 40.000 Token passen.
Choice und Score akzeptieren höchstens 255 Optionen oder Stufen.
usage.input_tokens summiert die internen Durchläufe für alle Fragen und kann daher 40.000 überschreiten, obwohl jeder einzelne gerenderte Prompt passt.
Eine Anfrage bewertet einen gemeinsamen state; legen Sie mehrere Fragen unter questions ab.
/v1/systemone unterstützt kein Streaming und akzeptiert keinen Batch unabhängiger States.
GLiDE unterstützt derzeit keine IDs feinabgestimmter Bereitstellungen.

Hinweise zu State-Formen, Konfidenzformeln und eine gemischte Choice/Score-Anfrage finden Sie in der GLiDE-Referenz.

Von TypeSafe migrieren

Jev von TypeSafe und GLiDE von Fastino verwenden dieselbe System-One-Struktur aus state, benannten questions und passenden answers. Die meisten Anfragen lassen sich problemlos übertragen, die Integration ist jedoch kein Drop-in-Ersatz. Verwenden Sie diese Checkliste für eine sichere Migration:

TypeSafe oder Jev	Fastino GLiDE
`https://api.typesafe.ai/v1/systemone`	`https://api.fastino.ai/v1/systemone`
`TYPESAFE_API_KEY`	`FASTINO_API_KEY`
`Authorization: Bearer $TYPESAFE_API_KEY`	`X-API-Key: $FASTINO_API_KEY`
Anfragemodell `jev-latest`	Anfragemodell `fastino/GLiDE`
Jev-Modell-ID in der Antwort	Antwortmodell `glide`
TypeSafe-SDK-Client	Ihr HTTP-Client, der `/v1/systemone` aufruft
Wiederholung bei `429` und `529`	Wiederholung bei `425`, `429` und `503` mit begrenztem Backoff

System-One-Anfragestruktur beibehalten

Behalten Sie den nicht leeren state, die Fragenschlüssel und die Primitivtypen bei. GLiDE verlangt, dass jeder instructions-Wert ein nicht leerer String ist. Wandeln Sie daher fehlende, null-, Objekt- oder Array-Anweisungen in klaren Text um. Behalten Sie Choice-Kriterien als Objekt bei. Noul-Kriterien sind optional, ihre true- und false-Werte müssen aber Strings sein. Verwenden Sie für Score-Kriterien bevorzugt ein geordnetes Array. Senden Sie nur die dokumentierten Anfragefelder, die Ihre Integration benötigt. Nicht unterstützte Felder auf oberster Ebene geben 422 zurück. Kopieren Sie daher keine beliebigen TypeSafe-Client-Optionen in den JSON-Body.

Endpunkt, Zugangsdaten und Modell ändern

Richten Sie die Anfrage an Fastino, lesen Sie FASTINO_API_KEY, senden Sie den Schlüssel mit X-API-Key und setzen Sie model auf fastino/GLiDE. Fastino akzeptiert auch den Bearer-Header, falls die Beibehaltung dieses Stils eine direkte HTTP-Migration vereinfacht. Erwarten Sie model: "glide" in der Antwort.

Verarbeitung von Score-Antworten aktualisieren

Der score von TypeSafe ist ein wahrscheinlichkeitsgewichteter Float. Das GLiDE-Äquivalent ist expected_level. Der score von GLiDE ist dagegen der ganzzahlige Index der wahrscheinlichsten Stufe. GLiDE gibt die Legendenbeschreibungen von Score als Strings zurück. Passen Sie daher Konsumenten an, die strukturierte Legendenwerte erwarten. Für Score-Anfragen akzeptiert GLiDE auch Kriterienobjekte mit numerischen String-Schlüsseln, etwa {"1": "low", "3": "medium", "5": "high"}. Die Schlüssel werden sortiert und verworfen, und die Antwort wird von 0 bis N-1 neu indiziert. Verwenden Sie ein geordnetes Array, wenn die ursprünglichen numerischen Werte nicht mit zurückgegebenen Stufenindizes verwechselt werden dürfen.

Stufenschlüssel und Wiederholungsverhalten prüfen

GLiDE gibt Score-probabilities und -legend mit String-Schlüsseln wie "0" und "1" zurück. Die rohe HTTP-Antwort von TypeSafe macht das ebenso, das Python-SDK kann jedoch ganzzahlige Schlüssel bereitstellen. Konvertieren Sie Schlüssel nur, wenn die Anwendung Maps mit ganzzahligen Schlüsseln benötigt. Ersetzen Sie die 529-Wiederholungslogik von TypeSafe durch die Behandlung von 425 und 503 bei Fastino und behalten Sie begrenztes Backoff für 429 bei. Beachten Sie Retry-After, sofern vorhanden, und wenden Sie dasselbe Wiederholungsbudget auf Transportfehler an.

Entscheidungsschwellenwerte neu validieren

Lassen Sie bestehende Geschäftsaktionen bei der Portierung unverändert und testen Sie GLiDE vor dem Deployment an repräsentativen Fällen. Gehen Sie nicht davon aus, dass für Jev kalibrierte Schwellenwerte unverändert auf ein anderes Modell übertragbar sind.

Bilden Sie den Gleitkomma-score von TypeSafe nicht auf den score von GLiDE ab. Lesen Sie answers.<key>.expected_level, wenn bestehender Code einen gewichteten Score erwartet. Lesen Sie answers.<key>.score nur, wenn der Code den Index der einzelnen gewinnenden Stufe benötigt.

TypeSafe-SDK-Nutzung ersetzen

Wenn das Projekt ein TypeSafe-SDK verwendet:

Suchen Sie typesafe-sdk, @typesafe-ai/sdk, TypeSafeClient, AsyncTypeSafeClient und TypeSafe-Fragekonstruktoren in Manifesten, Imports, Anwendungscode und Tests.
Ersetzen Sie SDK-Konstruktoren und typisierten Antwortzugriff durch den HTTP-Client des Projekts und dekodiertes JSON.
Entfernen Sie TypeSafe-Pakete und -Imports erst, wenn keine Referenzen mehr vorhanden sind.

Die oben genannten Regeln zu Endpunkt, Validierung, Wiederholungen und Score gelten weiterhin.

Fehler

Eine erste Anfrage an ein kaltes Modell kann während des Aufwärmens 425 model_warming zurückgeben; versuchen Sie es nach etwa 60 Sekunden erneut.

Status	Wahrscheinliche Ursache	Maßnahme
`400`	Der Prompt überschreitet das Kontextfenster oder eine andere Inferenzeingabe ist ungültig	Kürzen Sie den State oder korrigieren Sie die Frage
`401`	Fehlender, falsch formatierter oder ungültiger API-Schlüssel	Exportieren Sie einen gültigen `fast_sk_...`-Schlüssel
`402`	Unzureichende Credits, erforderliche Finanzierung oder ein vom Eigentümer festgelegtes tägliches/monatliches Ausgabenlimit	Fügen Sie Credits hinzu oder passen Sie das Ausgabenlimit an
`403`	Ablehnung wegen Zahlungsmethode, Kartenverifizierung, Kreditlimit oder Kontorichtlinie	Erfüllen Sie die Abrechnungs- oder Kontoanforderung
`404`	Unbekanntes Modell oder ein Modell, das nur Chat Completions unterstützt	Verwenden Sie `fastino/GLiDE`
`422`	Ein Pflichtfeld fehlt, ein Wert hat die falsche Form oder ein zusätzliches Feld wurde gesendet	Lesen und korrigieren Sie die Validierungsdetails auf Feldebene
`425`	Bereitstellung wird aufgewärmt	Wiederholen Sie den Vorgang nach der angegebenen Verzögerung
`429`	Rate- oder Kapazitätslimit	Beachten Sie `Retry-After` und wiederholen Sie mit Backoff
`503`	Vorübergehender Anbieter- oder Serving-Fehler	Wiederholen Sie den Vorgang, bevor Sie ihn als endgültig betrachten

Verwenden Sie ein Lese-Timeout von mindestens 300 Sekunden und begrenztes Backoff für 425, 429 und 503. Wiederholen Sie 401, 402, 403, 404 oder 422 nicht, ohne das zugrunde liegende Problem zu beheben.

Weiterlernen

GLiDE-Referenz

Verstehen Sie State-Formen, Limits, Konfidenz und das Kombinieren mehrerer Fragen.

Noul

Eine Ja/Nein-Wahrscheinlichkeit integrieren.

Choice

An eine benannte Option weiterleiten.

Score

Eine geordnete Rubrik bewerten.

Erste Schritte

Entscheidungsmodelle

Inferenz-API

Trainings-API

Modelle

Konto

GLiDE-Inferenz mit /v1/systemone

Ihren API-Schlüssel einrichten

Einen Fragetyp wählen

Anfrage

Vollständige Anfrage

Antwort

Limits und nicht unterstützte Formen

Von TypeSafe migrieren

TypeSafe-SDK-Nutzung ersetzen

Fehler

Weiterlernen

GLiDE-Referenz

Noul

Choice

Score

​Ihren API-Schlüssel einrichten

​Einen Fragetyp wählen

​Anfrage

​Vollständige Anfrage

​Antwort

​Limits und nicht unterstützte Formen

​Von TypeSafe migrieren

​TypeSafe-SDK-Nutzung ersetzen

​Fehler

​Weiterlernen

GLiDE-Referenz

Noul

Choice

Score

Ihren API-Schlüssel einrichten

Einen Fragetyp wählen

Anfrage

Vollständige Anfrage

Antwort

Limits und nicht unterstützte Formen

Von TypeSafe migrieren

TypeSafe-SDK-Nutzung ersetzen

Fehler

Weiterlernen