Skip to main content
POST
Strukturierte Entscheidungen treffen
Verwende POST /v1/decisions, wenn deine Anwendung strukturierte Antworten benötigt, die der Code direkt verarbeiten kann. Unterstützte Modelle sind TypeSafe Jev 1.13 (typesafe/jev-1.13.0), Together Tev1 4B Experimental (together/tev1-4b-experimental) und Respan Span-01 (respan/span-01:free und respan/span-01). Die Anfrage enthält:
  • state: ein String, Objekt oder Array mit den zu bewertenden Informationen.
  • questions: eine Map benannter Fragen. Jede Frage setzt type auf noul, choice oder score und enthält instructions; unterstützte Typen hängen vom ausgewählten Modell ab.
  • model: die Phaseo-Modell-ID. Verwende typesafe/jev-1.13.0 für Jev 1.13 oder typesafe/jev-latest, um jeweils die neueste Jev-Version zu nutzen.
Liquid D1 (liquid-ai/d1:free, auch als liquid-ai/d1 verfügbar) und Perplexity Decider 27B (perplexity/decider-27b) unterstützen alle drei Fragetypen. D1 ist während des experimentellen Early Access kostenlos. Decider kostet 0,04 USD pro Million Eingabetokens einschließlich Bildtokens; Ausgabetokens sind kostenlos. Hinterlege in Phaseo Anbieter-Zugangsdaten für Perplexity, um Decider zu nutzen. Sein Bildzustand verwendet Base64-Daten-URLs für PNG, JPEG oder WebP; entfernte Bild-URLs werden nicht unterstützt. Jede Auswahlfrage akzeptiert bis zu 255 Optionen und jede Bewertungsfrage bis zu 10 Stufen. Prüfe vor dem Aufruf die Verfügbarkeit des jeweiligen Modells. Für Respan Span-01 muss state ein Gesprächsabschnitt mit einem input-Array vorheriger Nachrichten und einer output-Assistentennachricht sein. Span-01 unterstützt nur noul-Fragen. Die noul-Antwort ist die Wahrscheinlichkeit, dass das Verhalten vorliegt; probabilities enthält außerdem Wahrscheinlichkeiten für fehlendes und nicht beobachtbares Verhalten.
respan/span-01:free ist das kostenlose Lite-Modell mit einem Tageslimit; Phaseo ordnet es der Respan-API-Modell-ID span-01-free zu. respan/span-01 entspricht der Respan-API-Modell-ID span-01-pro und wird von Respan mit 0,02 USD pro Million Eingabetokens abgerechnet; Ausgabetokens sind kostenlos. Span-01 befindet sich im Early Access, daher muss Respan den Zugriff für deine Organisation freischalten. Hinterlege vor dem Aufruf dieser Modelle deinen Respan-API-Schlüssel als Respan-Anbieter-Zugangsdaten in Phaseo. Antworten verwenden dieselben Schlüssel wie questions. choice-Antworten enthalten die gewählte Option, Wahrscheinlichkeiten und Konfidenz; noul-Antworten enthalten eine Wahrscheinlichkeit von 0 bis 1; score-Antworten enthalten einen wahrscheinlichkeitsgewichteten Score, eine Legende, Wahrscheinlichkeiten und Konfidenz. Für das Respan-Beispiel sieht eine Antwort so aus:
Jev unterstützt alle drei Fragetypen gemeinsam in einer Anfrage; Span-01 unterstützt nur noul-Fragen. Im Schnellstart findest du kopierbare Beispiele für cURL, JavaScript, das TypeScript-SDK und das Python-SDK. Jev 1.13 wird mit 0,042 USD pro Million Eingabetokens abgerechnet; Ausgabetokens sind kostenlos. Die Fragensemantik des Anbieters ist in der API-Referenz von TypeSafe beschrieben.

Bildentscheidungen mit Clef

cloudflare/clef und cloudflare/clef-flash unterstützen alle drei Fragetypen und eingebettete Bilder über Cloudflare Workers AI. Beide haben ein Kontextfenster von 65.536 Token. Die Eingabe kostet 0,24 USD pro Million Token für Clef und 0,09 USD für Clef Flash.
Sie können auch eine Zeichenfolge data:image/png;base64,... in images übergeben. Clef akzeptiert bis zu vier PNG-, JPEG- oder WebP-Bilder mit jeweils höchstens 4 MiB und 16 Megapixeln, insgesamt höchstens 8 MiB dekodierten Bilddaten und einem Anfragekörper von 13 MiB. Remote-URLs werden nicht unterstützt. Cloudflare prüft Bildformate und Abmessungen. Modelle ohne Bildunterstützung lehnen Bildanfragen ab. Clef akzeptiert höchstens 64 Fragen mit IDs aus bis zu 100 Buchstaben, Ziffern, Unterstrichen, Punkten oder Bindestrichen. Auswahlfragen benötigen 2–255 Optionen; Bewertungsfragen benötigen 2–10 Stufen. Siehe die Clef-Dokumentation von Cloudflare.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
Standard:typesafe/jev-1.13.0
erforderlich

Kanonische Phaseo-Modell-ID oder Modellalias des Anbieters.

state
erforderlich

Vom Modell bewerteter strukturierter Zustand.

questions
object
erforderlich
images
(string | object)[]

Eingebettete Bilder für bildfähige Entscheidungsmodelle. Clef akzeptiert PNG, JPEG oder WebP; Remote-URLs werden nicht unterstützt. Höchstens 4 MiB und 16 Megapixel pro Bild, insgesamt 8 MiB dekodierte Daten und 13 MiB pro Anfragekörper.

Maximum array length: 4
Pattern: ^[Dd][Aa][Tt][Aa]:image/(png|jpeg|webp);base64,[A-Za-z0-9+/]+={0,2}$
meta
boolean
Standard:false
echo_upstream_request
boolean
debug
object

Gateway-Debug-Steuerungen. Diese Flags werden niemals an den Anbieter weitergeleitet.

provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

routing
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

metadata
object

Antwort

200 - application/json

Antwort mit strukturierten Entscheidungen

model
string
answers
object
usage
object
request_id
string | null
meta
object
Zuletzt geändert am 2. Oktober 2026