Skip to main content
POST
Antwort erstellen

Servertools

/v1/responses unterstützt reguläre Funktionstools sowie diese vom Gateway verwalteten Servertools:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
  • phaseo:apply_patch

Beispiel für Datum und Uhrzeit

Bei Verwendung eines Servertools enthält die Nutzungsübersicht die passenden usage.server_tool_use.*-Zähler.
  • gateway:datetime -> datetime_requests
  • phaseo:web_search -> web_search_requests, web_search_results, web_search_extra_results
  • phaseo:web_fetch -> web_fetch_requests
  • phaseo:advisor -> advisor_requests
  • phaseo:image_generation -> image_generation_requests
  • phaseo:apply_patch -> apply_patch_requests

Hinweis zu Streaming

stream: true wird ebenfalls unterstützt. Bei vom Gateway verwalteten Servertools kann Phaseo den Upstream-Tool-Aufruf-Zug materialisieren, die Schleife fortsetzen und anschließend einen synthetischen Stream erneut ausgeben.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
input
erforderlich
background
boolean
include
string[]
instructions
string
max_output_tokens
integer
Erforderlicher Bereich: x >= 1
metadata
object
session_id
string

Eindeutige Kennung, um zusammengehörige Anfragen (zum Beispiel eine Unterhaltung oder einen Agenten-Workflow) für die Beobachtbarkeit zu gruppieren.

Maximum string length: 256
parallel_tool_calls
boolean
previous_response_id
string
reasoning
object
service_tier
enum<string>
Verfügbare Optionen:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
store
boolean
stream
boolean
temperature
number
Erforderlicher Bereich: 0 <= x <= 2
text
object
tool_choice

Strategie zur Toolauswahl. Phaseo-Servertool-Typen werden akzeptiert und in Funktions- oder Toolziele des Upstreams umgeschrieben.

Verfügbare Optionen:
auto,
none,
required,
phaseo:datetime,
phaseo:web_search,
phaseo:web_fetch,
phaseo:subagent,
phaseo:fusion,
phaseo:search_models,
gateway:datetime,
gateway:web_search,
gateway:web_fetch
tools
object[]

Werkzeugdefinitionen für Modell-Funktionsaufrufe und Gateway-Servertools. Die integrierten Gateway-Servertools sind gateway:datetime, gateway:web_search und gateway:web_fetch.

top_p
number
Erforderlicher Bereich: 0 <= x <= 1
truncation
enum<string>
Verfügbare Optionen:
auto,
disabled
user
string
prompt_cache_key
string | null
safety_identifier
string | null
modalities
enum<string>[]
Verfügbare Optionen:
text,
image,
audio
image_config
object
provider_options
object

Optionale anbieterspezifische Optionen.

usage
boolean
meta
boolean
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.

Antwort

Antwort

id
string
object
string
created
integer
model
string
provider
string
provider_id
string
nativeResponseId
string | null
status
enum<string>
Verfügbare Optionen:
completed,
failed,
incomplete
finish_reason
string | null
meta
object
cost_nanos
number
cost_cents
integer
currency
string
pricing_lines
object[]
output
object[]
output_items
object[]
content
object[]
role
string
stop_reason
string
type
string
usage
object
Zuletzt geändert am 2. Oktober 2026