Zum Hauptinhalt springen
POST
Strukturierte Entscheidungen treffen
Dieser Endpunkt hat den Status Beta. Sende input und ein geordnetes Array von questions an POST /v1/decisions und erhalte pro Frage eine typisierte Antwort mit Wahrscheinlichkeiten, in derselben Reihenfolge.

Eine Entscheidung treffen

Diese Anfrage stellt je eine Frage jedes Typs. Sie benötigt einen Phaseo-API-Schlüssel und eine verfügbare Route für openai/gpt-6-luna.
Die Antwort (Werte zur Veranschaulichung):

Fragen formulieren

input ist ein String oder ein Array von user-Nachrichten, deren content ein String oder eine Liste von input_text-, input_image-, input_audio- und input_video-Teilen ist. name ist optional; Antworten behalten die Reihenfolge der Anfrage bei, auch bei unbenannten und wiederholten Namen. Eine Anfrage enthält höchstens 128 Fragen, außer bei google/gemini-decision-1, das bis zu 1000 akzeptiert, bei parallel/decisions-fast, das bis zu 100 akzeptiert, und bei Clef, das bis zu 64 akzeptiert. Eine Anfrage über dem Limit des Modells gibt 400 zurück. Boolesche Auswahlwerte kommen als Booleans zurück. Ein Modell, das eine Frage ablehnt, gibt für sie type: "refusal" zurück. Welche Typen ein Modell unterstützt, steht unter Ein Modell wählen. Bilder gehören als Data-URLs in input_image-Teile. Gehostete HTTPS-Bild-URLs funktionieren nur bei den Base-Labs-Modellen (baselabs/elephant-1, baselabs/mammoth-1 und baselabs/joey-1) und müssen auf Amazon S3, Google Cloud Storage oder Azure Blob Storage liegen. Eine Anfrage enthält höchstens 128 Bilder, die Luna akzeptiert; andere Anbieter setzen niedrigere Grenzen. Ein explizites Bild-detail und safety_identifier erfordern eine OpenAI-Route.

Das ältere state-Format verwenden

Anfragen mit state und einer Map benannter Fragen funktionieren weiterhin und geben Antworten zurück, die nach denselben Namen geschlüsselt sind. Together Tev (together/tev1-4b-experimental) erfordert dieses Format, weil es eine Bezeichnung ohne Wahrscheinlichkeiten zurückgibt, und beantwortet nur choice-Fragen. Auch Respan Span-01 nutzt dieses Format. Mische die Formate nicht: input zusammen mit state oder images gibt 400 zurück.
  • state: ein String, Objekt oder Array mit den zu bewertenden Informationen.
  • questions: bis zu 128 benannte Fragen, bei Modellen mit höherem Limit mehr. Jede setzt type auf noul (Ja/Nein), choice oder score, dazu instructions. Auswahlfragen nehmen criteria als Map von Option zu Beschreibung; Bewertungsfragen nehmen criteria als Array mit mindestens zwei Stufenbeschreibungen.
  • locate-Fragen verwenden nur instructions und erfordern einen String als state ohne images; siehe Perplexity Decider.
  • images: bis zu vier PNG-, JPEG- oder WebP-Bilder, als data:-URLs oder { "content_type", "base64" }-Objekte.
  • model: standardmäßig typesafe/jev-1.13.0, wenn weggelassen.
Antworten verwenden dieselben Schlüssel wie questions. choice-Antworten enthalten die gewählte Option, Wahrscheinlichkeiten und Konfidenz; noul-Antworten eine Wahrscheinlichkeit von 0–1; score-Antworten einen wahrscheinlichkeitsgewichteten Wert, eine Legende, Wahrscheinlichkeiten und Konfidenz.

Ein Modell wählen

Prüfe die Modellverfügbarkeit, bevor du eines dieser Modelle aufrufst. Ausgabe-Tokens sind bei jedem Modell mit angegebenem Preis kostenlos.

TypeSafe Jev

Verwende typesafe/jev-1.13.0 für Jev 1.13 oder typesafe/jev-latest, um der neuesten Jev-Version zu folgen. Die Upstream-Semantik der Fragen findest du in der API-Referenz von TypeSafe. Auf unterstützenden TypeSafe-Routen akzeptieren Jev 1.13 und 1.14 eingebettete PNG- oder JPEG-Bilder über input_image oder das ältere Feld images. Phaseo erstellt die Bild-Assets für TypeSafe und aktiviert die Bildunterstützung automatisch. Bilder müssen die Bildgrenzen von TypeSafe einhalten: höchstens 16 MiB pro Bild, 256 bis 1568 Pixel pro Seite und mindestens 78.400 Pixel insgesamt. TypeSafe prüft Abmessungen und Kodierung und skaliert abgelehnte Bilder nicht. Der zugeordnete Upstream-JSON-Body ist auf 32 MiB begrenzt. Bild-Tokens kosten den normalen Eingabepreis. box (auf unterstützenden Routen wie Jev 1.14) erfordert ein Bild, nimmt keine Kriterien und gibt einen Begrenzungsrahmen samt Konfidenz zurück. Seine Kanten reichen von 0 bis 1, gemessen von der oberen linken Ecke. Box gibt immer ein Rechteck zurück, kombiniere es daher mit einer predicate-Frage zur Anwesenheit, wenn das Ziel fehlen kann. Beziehe dich beim älteren Feld images auf images[0], bei geordneter Eingabe auf das erste Bild oder [Image 0]. Siehe den Box-Vertrag. Setze provider_options.typesafe.long_context auf true, um die Kontextgrenzen pro Anfrage und pro Frage auf 262k Tokens anzuheben, statt der Standardwerte von 64k pro Anfrage und 32k pro Frage. Langer Kontext kostet pro Token gleich viel. Bilder, Box und langer Kontext sind experimentelle Upstream-Funktionen.

Cloudflare Clef und Clef Flash

cloudflare/clef und cloudflare/clef-flash laufen auf Cloudflare Workers AI. Clef hat ein Kontextfenster von 65.536 Tokens, Clef Flash von 24.576 Tokens.
images akzeptiert auch einen String data:image/png;base64,.... Clef akzeptiert bis zu vier PNG-, JPEG- oder WebP-Bilder mit jeweils höchstens 4 MiB und 16 Megapixeln, insgesamt höchstens 8 MiB dekodierter Bilddaten und einem Anfrage-Body von 13 MiB. Externe URLs werden nicht unterstützt, und 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 und Bewertungsfragen 2–10 Stufen. Siehe die Clef-Dokumentation von Cloudflare.

Cloudflare Clef Omni

cloudflare/clef-omni akzeptiert Text, Bilder, Audio und Video. Audio- und Videoteile sind Phaseo-Erweiterungen des Eingabeformats; OpenAI-Routen akzeptieren nur Text und Bilder. Ersetze die Platzhalter-Audiobytes und die Video-URL durch deine eigenen Medien, bevor du dieses Beispiel sendest.
Sende Audio als input_audio.data mit format: "wav" oder "mp3" oder als input_audio.url mit einer öffentlichen HTTPS-URL oder einer eingebetteten Audio-Data-URL. input_video.video_url nimmt einen String oder { "url": "..." } mit einer öffentlichen HTTPS-URL oder einer eingebetteten MP4-/WebM-Data-URL. Externe Server müssen den passenden Content-Type zurückgeben. Phaseo ruft URLs mit Größenbegrenzungen sowie Prüfungen auf private Adressen und Weiterleitungen ab und bettet die Medien dann für Cloudflare ein; Anbieterzugangsdaten werden nie an den Medienserver gesendet. Cloudflare prüft Medienkodierung, Bildabmessungen und Cliplänge und tastet Video mit zwei Bildern pro Sekunde ab. Die Tonspur eines Videos wird verwendet, wenn jedes Video in der Anfrage eine hat. Medien-Tokens zählen zum Kontext und zur Abrechnung; Phaseo rechnet anhand der von Cloudflare gemeldeten Eingabenutzung ab und berechnet Audio oder Video nicht gesondert. Siehe den Omni-Vertrag von Cloudflare.

Liquid D1.2 und D1.2 Ultra

liquid-ai/d1.2 und liquid-ai/d1.2-ultra nutzen das ältere state-Format, mit bis zu vier Bildern und bis zu acht Audioclips. Sende audio als base64-data:-URLs (WAV, MP3, FLAC, M4A oder OGG, je URL höchstens 24 MiB, also etwa 18 MiB Audio); entfernte Audio-URLs werden nicht unterstützt. Neben noul, choice und score beantworten sie diese Fragetypen: Setze multiple: true bei einer choice-Frage, um alle zutreffenden Optionen als choices mit probabilities je Option zu erhalten. Andere Modelle geben für diese Fragetypen 400 zurück und beantworten multiple-Fragen mit einer einzigen Option; Modelle ohne Audioeingabe ignorieren audio. liquid-ai/d1, liquid-ai/d1.1 und liquid-ai/d1-ultra nehmen Text und Bilder an und beantworten noul, choice und score.

Liquid D1 und Perplexity Decider

Liquid D1 (liquid-ai/d1:free) ist während des experimentellen Early Access kostenlos. Perplexity Decider V1.3 (perplexity/pplx-decider-v1.3 oder perplexity/pplx-decider-latest) und Decider Flash V1.3 (perplexity/pplx-decider-flash-v1.3 oder perplexity/pplx-decider-flash-latest) benötigen Perplexity-Anbieterzugangsdaten in Phaseo. Ihr Bildzustand verwendet Base64-Data-URLs im PNG-, JPEG- oder WebP-Format; externe Bild-URLs werden nicht unterstützt. Sie beantworten außerdem locate-Fragen, die die Teile eines String-input oder -state zurückgeben, die zu den instructions passen, etwa "email address". Jeder Abschnitt enthält wörtlich kopierten text, die Positionen start und end in Unicode-Codepunkten (end ist exklusiv) und einen score, bei dem höher sicherer bedeutet; spans ist leer, wenn nichts passt. Locate nimmt keine criteria und keine Bilder, Audio- oder Videodaten an und funktioniert nur bei Modellen, die es angeben; andere Modelle geben 400 zurück. Perplexity hat es mit Eingaben von bis zu 8K Tokens trainiert. Bei beiden akzeptiert eine Auswahlfrage bis zu 255 Optionen und eine Bewertungsfrage bis zu 10 Stufen.

Inception Mercury Decide

inception/mercury-decide nimmt Text oder JSON als Beleg. Auswahlfragen akzeptieren bis zu 255 Optionen und Bewertungsfragen bis zu 10 Stufen. Bilder, Streaming und Tool-Aufrufe werden nicht unterstützt. Der Eingabepreis von $0.02 ist eine 50-%-Aktion von Inception ohne veröffentlichtes Enddatum; prüfe vor der Nutzung die aktuellen Upstream-Preise.

Microsoft Decision

microsoft/microsoft-decision-1 läuft auf einem Azure-Foundry-Deployment und nimmt Text oder JSON als Beleg mit bis zu 32.768 Tokens. Medien, Streaming, Tools, safety_identifier und service_tier werden nicht unterstützt. Siehe den Leitfaden von Microsoft.

Respan Span-01

Span-01 verwendet das ältere Format. state muss ein Gesprächsausschnitt sein: ein input-Array vorangehender Nachrichten und eine output-Assistentennachricht. Es beantwortet nur noul-Fragen: Der noul-Wert ist die Wahrscheinlichkeit, dass das Verhalten vorliegt, und probabilities gibt außerdem die Wahrscheinlichkeiten für „nicht vorhanden“ und „nicht beobachtbar“ an.
Eine Antwort sieht so aus:
respan/span-01:free ist das kostenlose Lite-Modell mit Tageslimit und entspricht dem Respan-Modell span-01-free. respan/span-01 entspricht span-01-pro und wird von Respan abgerechnet. Span-01 ist im Early Access: Respan muss es für deine Organisation freischalten, und du hinterlegst deinen Respan-API-Schlüssel als Respan-Anbieterzugangsdaten in Phaseo, bevor du eines der beiden Modelle aufrufst.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json

Das OpenAI-Format wird empfohlen. Das bisherige Format bleibt unterstützt. Die Antwort folgt der Anfrage; Formate nicht mischen.

model
string
erforderlich

Kanonische Phaseo-Modell-ID oder Modellalias des Anbieters.

Minimum string length: 1
input
erforderlich

Text oder Nachrichten mit eingebetteten Bildern. Audio und Video sind Phaseo-Erweiterungen für unterstützende Modelle; OpenAI-Entscheidungsrouten unterstützen diese nicht.

Maximum string length: 10485760
questions
object[]
erforderlich
Required array length: 1 - 1000 elements
models
string[]

Optionale, geordnete Fallback-Modelle, die nach model versucht werden. model ist erforderlich und immer das primäre Modell. Schlägt ein Versuch mit 429, 500, 502, 503 oder 504 fehl, wird der nächste Eintrag versucht; andere Fehler werden unverändert zurückgegeben. Akzeptiert bis zu 25 Modell-IDs oder Presets; Duplikate und Einträge, die model entsprechen, werden ignoriert. Jeder Versuch wird als eigene Anfrage validiert, protokolliert und abgerechnet, und das Feld model der Antwort sowie der Routing-Trace zeigen das Modell, das die Anfrage bedient hat. Streaming-Anfragen weichen nur vor dem ersten Byte aus, Video- und Musikjobs nur bei der Übermittlung. Batch-, Realtime- und Council-Anfragen lehnen models ab. Auf einer dynamischen Route festgelegte Fallbacks haben Vorrang, und phaseo/auto kann nicht mit models kombiniert werden.

Required array length: 1 - 25 elements
Minimum string length: 1
Beispiel:
provider_options
object
safety_identifier
string | null

Undurchsichtige Benutzerkennung. Nur OpenAI-Routen.

Maximum string length: 128
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

Geordnete Antworten für input/Array; benannte Map für bisheriges state/Map.

model
string
erforderlich
answers
object[]
erforderlich

Eine Antwort je Frage in Reihenfolge, auch ohne Namen oder mit gleichen Namen.

usage
object
erforderlich
request_id
string | null
meta
object
Zuletzt geändert am 16. November 2026