> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Claude - Nachrichten-API
> - Senden Sie eine strukturierte Liste von Eingabenachrichten mit Text- und/oder Bildinhalten, und das Modell generiert die nächste Nachricht in der Konversation.
- Die Messages API kann sowohl für einzelne Abfragen als auch für zustandslose Mehrfachdurchlauf-Konversationen verwendet werden.
**BaseURL**: Die Standard-BaseURL ist `https://direct.evolink.ai` und bietet bessere Unterstützung für Textmodelle sowie persistente Verbindungen. `https://api.evolink.ai` ist der primäre Endpunkt für multimodale Dienste und dient bei Textmodellen als Ausweichadresse.
## OpenAPI
````yaml de/api-manual/language-series/claude/claude-messages-api.json POST /v1/messages
openapi: 3.1.0
info:
title: Claude Nachrichten-API
description: >-
Senden Sie eine strukturierte Liste von Eingabenachrichten mit Text-
und/oder Bildinhalten, und das Modell generiert die nächste Nachricht in der
Konversation. Die Messages API kann sowohl für einzelne Abfragen als auch
für zustandslose Mehrfachdurchlauf-Konversationen verwendet werden.
license:
name: MIT
version: 1.0.0
servers:
- url: https://direct.evolink.ai
description: Produktion (empfohlen)
- url: https://api.evolink.ai
description: Alternative URL
security:
- bearerAuth: []
tags:
- name: Messages
description: Claude KI-Nachrichtengenerierung und Konversations-APIs
paths:
/v1/messages:
post:
tags:
- Messages
summary: Eine Nachricht erstellen
description: >-
- Senden Sie eine strukturierte Liste von Eingabenachrichten mit Text-
und/oder Bildinhalten, und das Modell generiert die nächste Nachricht in
der Konversation.
- Die Messages API kann sowohl für einzelne Abfragen als auch für
zustandslose Mehrfachdurchlauf-Konversationen verwendet werden.
operationId: createMessage
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateMessageParams'
example:
model: claude-opus-4-8
max_tokens: 1024
messages:
- role: user
content: Hello, world
responses:
'200':
description: Nachrichtenobjekt
content:
application/json:
schema:
$ref: '#/components/schemas/Message'
example:
model: claude-haiku-4-5-20251001
id: msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz
type: message
role: assistant
content:
- type: text
text: |-
# Hey there! 👋
How's it going? What can I help you with today?
stop_reason: end_turn
stop_sequence: null
usage:
input_tokens: 8
cache_creation_input_tokens: 0
cache_read_input_tokens: 0
output_tokens: 24
'400':
description: Ungültige Anfrage
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Ungültige Anfrage
type: invalid_request_error
request_id:
type: error
'401':
description: Authentifizierungsfehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Authentifizierungsfehler
type: authentication_error
request_id:
type: error
'402':
description: Abrechnungsfehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Abrechnungsfehler
type: billing_error
request_id:
type: error
fallback_suggestion: https://evolink.ai/dashboard/billing
'403':
description: Berechtigungsfehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Permission denied
type: permission_error
request_id:
type: error
'404':
description: Nicht gefunden
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Nicht gefunden
type: not_found_error
request_id:
type: error
'429':
description: Ratenlimit-Fehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Rate limited
type: rate_limit_error
request_id:
type: error
fallback_suggestion: retry after 60 seconds
'500':
description: Interner Serverfehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Interner Serverfehler
type: api_error
request_id:
type: error
fallback_suggestion: try again later
'503':
description: Dienst überlastet
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Overloaded
type: overloaded_error
request_id:
type: error
fallback_suggestion: retry after 30 seconds
'524':
description: Cloudflare-Gateway-Timeout-Fehler
content:
application/json:
schema:
$ref: 955ae699-9399-4476-b592-d55e78b0d5eb
example:
error:
message: Request timeout
type: timeout_error
request_id:
type: error
fallback_suggestion: >-
Bitte wechseln Sie die BaseURL zu https://direct.evolink.ai;
dieser Endpunkt eignet sich besser für lange Aufgaben
components:
schemas:
CreateMessageParams:
type: object
required:
- model
- messages
- max_tokens
additionalProperties: false
properties:
model:
type: string
description: Das Modell, das Ihren Prompt vervollständigen wird.
enum:
- claude-haiku-4-5-20251001
- claude-sonnet-4-5-20250929
- claude-opus-4-5-20251101
- claude-opus-4-6
- claude-fable-5
- claude-opus-4-8
- claude-opus-4-7
- claude-sonnet-4-6
- claude-sonnet-5
examples:
- claude-opus-4-8
title: Model
messages:
type: array
description: >-
Eingabenachrichten.
Unsere Modelle sind darauf trainiert, abwechselnd `user`- und
`assistant`-Gesprächsrunden zu verarbeiten. Beim Erstellen einer
neuen `Message` geben Sie die vorherigen Gesprächsrunden mit dem
Parameter `messages` an, und das Modell generiert dann die nächste
`Message` in der Konversation. Aufeinanderfolgende `user`- oder
`assistant`-Runden in Ihrer Anfrage werden zu einer einzelnen Runde
zusammengefasst.
Jede Eingabenachricht muss ein Objekt mit `role` und `content` sein.
Sie können eine einzelne `user`-Rollennachricht angeben oder mehrere
`user`- und `assistant`-Nachrichten einschließen.
items:
$ref: '#/components/schemas/InputMessage'
title: Messages
max_tokens:
type: integer
description: >-
Die maximale Anzahl von Tokens, die vor dem Stoppen generiert werden
sollen.
Beachten Sie, dass unsere Modelle möglicherweise _vor_ Erreichen
dieses Maximums stoppen. Dieser Parameter gibt nur die absolute
maximale Anzahl der zu generierenden Tokens an.
examples:
- 1024
minimum: 1
title: Maximale Token
inference_geo:
type: string
description: >-
Specifies the geographic region for inference processing. If not
specified, the workspace's `default_inference_geo` is used.
title: Inference Geo
container:
description: Container-Bezeichner zur Wiederverwendung über Anfragen hinweg.
title: Container
anyOf:
- $ref: '#/components/schemas/ContainerParams'
- type: string
- type: 'null'
context_management:
description: Kontextverwaltungskonfiguration.
anyOf:
- $ref: '#/components/schemas/ContextManagementConfig'
- type: 'null'
mcp_servers:
type: array
description: MCP-Server, die in dieser Anfrage verwendet werden sollen
items:
$ref: '#/components/schemas/RequestMCPServerURLDefinition'
maxItems: 20
title: MCP-Server
metadata:
$ref: '#/components/schemas/Metadata'
description: Ein Objekt, das Metadaten über die Anfrage beschreibt.
output_config:
$ref: '#/components/schemas/OutputConfig'
description: >-
Configuration options for the model's output, such as the output
format.
service_tier:
type: string
description: >-
Bestimmt, ob für diese Anfrage Prioritätskapazität (falls verfügbar)
oder Standardkapazität verwendet werden soll.
enum:
- auto
- standard_only
title: Dienststufe
stop_sequences:
type: array
description: >-
Benutzerdefinierte Textsequenzen, die das Modell zum Stoppen der
Generierung veranlassen.
items:
type: string
title: Stoppsequenzen
stream:
type: boolean
description: >-
Ob die Antwort inkrementell mittels Server-Sent Events gestreamt
werden soll.
title: Stream
system:
description: System-Prompt.
examples:
- Today's date is 2024-06-01.
title: System
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/RequestTextBlock'
temperature:
type: number
description: |-
Menge an Zufälligkeit, die in die Antwort eingebracht wird.
Standardwert ist `1.0`. Bereich von `0.0` bis `1.0`.
examples:
- 1
minimum: 0
maximum: 1
title: Temperature
thinking:
description: >-
Konfiguration zur Aktivierung von Claudes erweitertem Denken.
`type: "enabled"` erfordert `budget_tokens` mit mindestens 1.024 und
wird auf `max_tokens` angerechnet. Über `display` können Sie
steuern, wie Thinking-Inhalte angezeigt werden.
`type: "adaptive"` lässt Claude je nach Komplexität der Anfrage
selbst entscheiden, wann und wie viel erweitertes Denken verwendet
wird; auch hier steuert `display` die Anzeige der Thinking-Inhalte.
`type: "disabled"` deaktiviert erweitertes Denken.
anyOf:
- $ref: '#/components/schemas/ThinkingConfigEnabled'
- $ref: '#/components/schemas/ThinkingConfigAdaptive'
- $ref: '#/components/schemas/ThinkingConfigDisabled'
tool_choice:
description: Wie das Modell die bereitgestellten Werkzeuge verwenden soll.
anyOf:
- $ref: '#/components/schemas/ToolChoiceAuto'
- $ref: '#/components/schemas/ToolChoiceAny'
- $ref: '#/components/schemas/ToolChoiceTool'
- $ref: '#/components/schemas/ToolChoiceNone'
tools:
type: array
description: Definitionen von Werkzeugen, die das Modell verwenden kann.
items:
anyOf:
- $ref: '#/components/schemas/Tool'
- $ref: '#/components/schemas/BashTool_20241022'
- $ref: '#/components/schemas/BashTool_20250124'
- $ref: '#/components/schemas/CodeExecutionTool_20250522'
- $ref: '#/components/schemas/CodeExecutionTool_20250825'
- $ref: '#/components/schemas/ComputerUseTool_20241022'
- $ref: '#/components/schemas/MemoryTool_20250818'
- $ref: '#/components/schemas/ComputerUseTool_20250124'
- $ref: '#/components/schemas/TextEditor_20241022'
- $ref: '#/components/schemas/TextEditor_20250124'
- $ref: '#/components/schemas/TextEditor_20250429'
- $ref: '#/components/schemas/TextEditor_20250728'
- $ref: '#/components/schemas/WebSearchTool_20250305'
- $ref: '#/components/schemas/WebFetchTool_20250910'
title: Tools
top_k:
type: integer
description: Nur aus den Top-K-Optionen für jedes nachfolgende Token samplen.
examples:
- 5
minimum: 0
title: Top K
top_p:
type: number
description: Nucleus-Sampling verwenden.
examples:
- 0.7
minimum: 0
maximum: 1
title: Top P
Message:
type: object
required:
- id
- type
- role
- content
- model
- stop_reason
- stop_sequence
- usage
properties:
id:
type: string
description: |-
Eindeutiger Objektbezeichner.
Format und Länge der IDs können sich im Laufe der Zeit ändern.
examples:
- msg_013Zva2CMHLNnXjNJJKqJ2EF
title: Id
type:
type: string
const: message
description: |-
Objekttyp.
Für Messages ist dies immer `"message"`.
title: Type
role:
type: string
const: assistant
description: |-
Gesprächsrolle der generierten Nachricht.
Dies ist immer `"assistant"`.
title: Role
content:
type: array
description: >-
Vom Modell generierter Inhalt.
Dies ist ein Array von Inhaltsblöcken, von denen jeder einen `type`
hat, der seine Struktur bestimmt.
items:
anyOf:
- $ref: '#/components/schemas/ResponseTextBlock'
- $ref: '#/components/schemas/ResponseThinkingBlock'
- $ref: '#/components/schemas/ResponseRedactedThinkingBlock'
- $ref: '#/components/schemas/ResponseToolUseBlock'
- $ref: '#/components/schemas/ResponseServerToolUseBlock'
- $ref: '#/components/schemas/ResponseWebSearchToolResultBlock'
- $ref: '#/components/schemas/ResponseWebFetchToolResultBlock'
- $ref: '#/components/schemas/ResponseCodeExecutionToolResultBlock'
- $ref: '#/components/schemas/ResponseBashCodeExecutionToolResultBlock'
- $ref: >-
#/components/schemas/ResponseTextEditorCodeExecutionToolResultBlock
- $ref: '#/components/schemas/ResponseMCPToolUseBlock'
- $ref: '#/components/schemas/ResponseMCPToolResultBlock'
- $ref: '#/components/schemas/ResponseContainerUploadBlock'
title: Content
model:
type: string
description: Das Modell, das die Anfrage verarbeitet hat.
enum:
- claude-haiku-4-5-20251001
- claude-sonnet-4-5-20250929
- claude-opus-4-5-20251101
- claude-opus-4-6
- claude-fable-5
- claude-opus-4-8
- claude-opus-4-7
- claude-sonnet-4-6
- claude-sonnet-5
examples:
- claude-opus-4-8
title: Model
stop_reason:
type: string
nullable: true
description: Der Grund für das Stoppen.
enum:
- end_turn
- max_tokens
- stop_sequence
- tool_use
- pause_turn
- refusal
- model_context_window_exceeded
title: Stoppgrund
stop_sequence:
type: string
nullable: true
description: >-
Welche benutzerdefinierte Stoppsequenz generiert wurde, falls
vorhanden.
title: Stoppsequenz
usage:
$ref: '#/components/schemas/Usage'
description: Abrechnungs- und Ratenlimit-Nutzung.
context_management:
anyOf:
- $ref: '#/components/schemas/ResponseContextManagement'
- type: 'null'
description: Kontextverwaltungsantwort.
container:
anyOf:
- $ref: '#/components/schemas/Container'
- type: 'null'
description: Informationen über den in dieser Anfrage verwendeten Container.
InputMessage:
additionalProperties: false
properties:
content:
anyOf:
- type: string
- items:
discriminator:
mapping:
bash_code_execution_tool_result:
$ref: >-
#/components/schemas/RequestBashCodeExecutionToolResultBlock
code_execution_tool_result:
$ref: '#/components/schemas/RequestCodeExecutionToolResultBlock'
container_upload:
$ref: '#/components/schemas/RequestContainerUploadBlock'
document:
$ref: '#/components/schemas/RequestDocumentBlock'
image:
$ref: '#/components/schemas/RequestImageBlock'
mcp_tool_result:
$ref: '#/components/schemas/RequestMCPToolResultBlock'
mcp_tool_use:
$ref: '#/components/schemas/RequestMCPToolUseBlock'
redacted_thinking:
$ref: '#/components/schemas/RequestRedactedThinkingBlock'
search_result:
$ref: '#/components/schemas/RequestSearchResultBlock'
server_tool_use:
$ref: '#/components/schemas/RequestServerToolUseBlock'
text:
$ref: '#/components/schemas/RequestTextBlock'
text_editor_code_execution_tool_result:
$ref: >-
#/components/schemas/RequestTextEditorCodeExecutionToolResultBlock
thinking:
$ref: '#/components/schemas/RequestThinkingBlock'
tool_result:
$ref: '#/components/schemas/RequestToolResultBlock'
tool_use:
$ref: '#/components/schemas/RequestToolUseBlock'
web_fetch_tool_result:
$ref: '#/components/schemas/RequestWebFetchToolResultBlock'
web_search_tool_result:
$ref: '#/components/schemas/RequestWebSearchToolResultBlock'
propertyName: type
oneOf:
- $ref: '#/components/schemas/RequestTextBlock'
description: Regulärer Textinhalt.
- $ref: '#/components/schemas/RequestImageBlock'
description: >-
Bildinhalt, der direkt als Base64-Daten oder als Referenz
über eine URL angegeben wird.
- $ref: '#/components/schemas/RequestDocumentBlock'
description: >-
Dokumentinhalt, entweder direkt als Base64-Daten, als Text
oder als Referenz über eine URL angegeben.
- $ref: '#/components/schemas/RequestSearchResultBlock'
description: >-
Ein Suchergebnisblock mit Quelle, Titel und Inhalt aus
Suchvorgängen.
- $ref: '#/components/schemas/RequestThinkingBlock'
description: Ein Block, der internes Denken des Modells angibt.
- $ref: '#/components/schemas/RequestRedactedThinkingBlock'
description: >-
Ein Block, der internes, geschwärztes Denken des Modells
angibt.
- $ref: '#/components/schemas/RequestToolUseBlock'
description: >-
Ein Block, der eine Werkzeugverwendung durch das Modell
anzeigt.
- $ref: '#/components/schemas/RequestToolResultBlock'
description: >-
Ein Block, der die Ergebnisse einer Werkzeugverwendung
durch das Modell angibt.
- $ref: '#/components/schemas/RequestServerToolUseBlock'
- $ref: '#/components/schemas/RequestWebSearchToolResultBlock'
- $ref: '#/components/schemas/RequestWebFetchToolResultBlock'
- $ref: '#/components/schemas/RequestCodeExecutionToolResultBlock'
- $ref: >-
#/components/schemas/RequestBashCodeExecutionToolResultBlock
- $ref: >-
#/components/schemas/RequestTextEditorCodeExecutionToolResultBlock
- $ref: '#/components/schemas/RequestMCPToolUseBlock'
- $ref: '#/components/schemas/RequestMCPToolResultBlock'
- $ref: '#/components/schemas/RequestContainerUploadBlock'
type: array
title: Content
role:
enum:
- user
- assistant
title: Role
type: string
required:
- content
- role
title: InputMessage
type: object
ContainerParams:
additionalProperties: false
description: Container-Parameter mit zu ladenden Skills.
properties:
id:
anyOf:
- type: string
- type: 'null'
description: Container-ID
title: Id
skills:
anyOf:
- items:
$ref: '#/components/schemas/SkillParams'
maxItems: 8
type: array
- type: 'null'
description: Liste der im Container zu ladenden Skills
title: Skills
title: ContainerParams
type: object
ContextManagementConfig:
additionalProperties: false
properties:
edits:
description: Liste der anzuwendenden Kontextverwaltungsänderungen
items:
discriminator:
mapping:
clear_thinking_20251015:
$ref: '#/components/schemas/ClearThinking20251015'
clear_tool_uses_20250919:
$ref: '#/components/schemas/ClearToolUses20250919'
propertyName: type
oneOf:
- $ref: '#/components/schemas/ClearToolUses20250919'
- $ref: '#/components/schemas/ClearThinking20251015'
minItems: 0
title: Edits
type: array
title: ContextManagementConfig
type: object
RequestMCPServerURLDefinition:
additionalProperties: false
properties:
authorization_token:
anyOf:
- type: string
- type: 'null'
title: Autorisierungs-Token
name:
title: Name
type: string
tool_configuration:
anyOf:
- $ref: '#/components/schemas/RequestMCPServerToolConfiguration'
- type: 'null'
type:
const: url
title: Type
type: string
url:
title: Url
type: string
required:
- name
- type
- url
title: RequestMCPServerURLDefinition
type: object
Metadata:
additionalProperties: false
properties:
user_id:
anyOf:
- maxLength: 256
type: string
- type: 'null'
description: >-
Ein externer Bezeichner für den Benutzer, der mit der Anfrage
verknüpft ist.
Dies sollte eine UUID, ein Hash-Wert oder ein anderer
undurchsichtiger Bezeichner sein. Anthropic kann diese ID verwenden,
um Missbrauch zu erkennen. Fügen Sie keine identifizierenden
Informationen wie Name, E-Mail-Adresse oder Telefonnummer hinzu.
examples:
- 13803d75-b4b5-4c3e-b2a2-6f21399b021b
title: Benutzer-ID
title: Metadata
type: object
OutputConfig:
additionalProperties: false
properties:
effort:
description: Ausgabebedarf.
enum:
- low
- medium
- high
- xhigh
- max
title: Effort
type: string
format:
$ref: '#/components/schemas/JSONOutputFormat'
description: Schema zur Einschränkung des Claude-Ausgabeformats.
task_budget:
$ref: '#/components/schemas/TokenTaskBudget'
description: Gesamtes Token-Budget über Kontexte hinweg.
title: OutputConfig
type: object
RequestTextBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
citations:
anyOf:
- items:
discriminator:
mapping:
char_location:
$ref: '#/components/schemas/RequestCharLocationCitation'
content_block_location:
$ref: '#/components/schemas/RequestContentBlockLocationCitation'
page_location:
$ref: '#/components/schemas/RequestPageLocationCitation'
search_result_location:
$ref: '#/components/schemas/RequestSearchResultLocationCitation'
web_search_result_location:
$ref: >-
#/components/schemas/RequestWebSearchResultLocationCitation
propertyName: type
oneOf:
- $ref: '#/components/schemas/RequestCharLocationCitation'
- $ref: '#/components/schemas/RequestPageLocationCitation'
- $ref: '#/components/schemas/RequestContentBlockLocationCitation'
- $ref: >-
#/components/schemas/RequestWebSearchResultLocationCitation
- $ref: '#/components/schemas/RequestSearchResultLocationCitation'
type: array
- type: 'null'
title: Citations
text:
minLength: 1
title: Text
type: string
type:
const: text
title: Type
type: string
required:
- text
- type
title: Text
type: object
ThinkingConfigEnabled:
additionalProperties: false
properties:
budget_tokens:
description: >-
Bestimmt, wie viele Tokens Claude für seinen internen Denkprozess
verwenden kann. Größere Budgets können eine gründlichere Analyse
komplexer Probleme ermöglichen und die Antwortqualität verbessern.
Muss ≥1024 und kleiner als `max_tokens` sein.
Siehe [erweitertes
Denken](https://docs.claude.com/de/docs/build-with-claude/extended-thinking)
für Details.
minimum: 1024
title: Budget-Tokens
type: integer
display:
description: Steuert, wie Thinking-Inhalte in der Antwort angezeigt werden.
enum:
- summarized
- omitted
title: Anzeige
type: string
type:
const: enabled
title: Type
type: string
required:
- budget_tokens
- type
title: Enabled
type: object
ThinkingConfigAdaptive:
additionalProperties: false
properties:
display:
description: Steuert, wie Thinking-Inhalte in der Antwort angezeigt werden.
enum:
- summarized
- omitted
title: Anzeige
type: string
type:
const: adaptive
title: Type
type: string
required:
- type
title: Adaptive
type: object
ThinkingConfigDisabled:
additionalProperties: false
properties:
type:
const: disabled
title: Type
type: string
required:
- type
title: Disabled
type: object
ToolChoiceAuto:
additionalProperties: false
description: Das Modell entscheidet automatisch, ob Werkzeuge verwendet werden.
properties:
disable_parallel_tool_use:
description: >-
Ob die parallele Werkzeugverwendung deaktiviert werden soll.
Standardwert ist `false`. Wenn auf `true` gesetzt, gibt das Modell
höchstens eine Werkzeugverwendung aus.
title: Parallele Werkzeugnutzung deaktivieren
type: boolean
type:
const: auto
title: Type
type: string
required:
- type
title: Auto
type: object
ToolChoiceAny:
additionalProperties: false
description: Das Modell wird alle verfügbaren Werkzeuge verwenden.
properties:
disable_parallel_tool_use:
description: >-
Ob die parallele Werkzeugverwendung deaktiviert werden soll.
Standardwert ist `false`. Wenn auf `true` gesetzt, gibt das Modell
genau eine Werkzeugverwendung aus.
title: Parallele Werkzeugnutzung deaktivieren
type: boolean
type:
const: any
title: Type
type: string
required:
- type
title: Any
type: object
ToolChoiceTool:
additionalProperties: false
description: >-
Das Modell wird das angegebene Werkzeug mit `tool_choice.name`
verwenden.
properties:
disable_parallel_tool_use:
description: >-
Ob die parallele Werkzeugverwendung deaktiviert werden soll.
Standardwert ist `false`. Wenn auf `true` gesetzt, gibt das Modell
genau eine Werkzeugverwendung aus.
title: Parallele Werkzeugnutzung deaktivieren
type: boolean
name:
description: Der Name des zu verwendenden Werkzeugs.
title: Name
type: string
type:
const: tool
title: Type
type: string
required:
- name
- type
title: Tool
type: object
ToolChoiceNone:
additionalProperties: false
description: Das Modell darf keine Werkzeuge verwenden.
properties:
type:
const: none
title: Type
type: string
required:
- type
title: None
type: object
Tool:
additionalProperties: false
properties:
type:
anyOf:
- type: 'null'
- const: custom
type: string
title: Type
description:
description: >-
Beschreibung der Funktion dieses Werkzeugs.
Werkzeugbeschreibungen sollten so detailliert wie möglich sein. Je
mehr Informationen das Modell darüber hat, was das Werkzeug ist und
wie es verwendet wird, desto besser wird es funktionieren. Sie
können natürlichsprachliche Beschreibungen verwenden, um wichtige
Aspekte des Werkzeug-Eingabe-JSON-Schemas zu verstärken.
examples:
- Das aktuelle Wetter an einem bestimmten Ort abrufen
title: Description
type: string
name:
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
maxLength: 128
minLength: 1
pattern: ^[a-zA-Z0-9_-]{1,128}$
title: Name
type: string
input_schema:
$ref: '#/components/schemas/InputSchema'
description: >-
[JSON-Schema](https://json-schema.org/draft/2020-12) für die Eingabe
dieses Werkzeugs.
Dies definiert die Struktur der `input`, die Ihr Werkzeug akzeptiert
und die das Modell erzeugen wird.
examples:
- properties:
location:
description: Stadt und Bundesstaat, z. B. San Francisco, CA
type: string
unit:
description: Einheit für die Ausgabe – eine von (celsius, fahrenheit)
type: string
required:
- location
type: object
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
required:
- name
- input_schema
title: Benutzerdefiniertes Tool
type: object
BashTool_20241022:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: bash
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: bash_20241022
title: Type
type: string
required:
- name
- type
title: Bash-Tool (2024-10-22)
type: object
BashTool_20250124:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: bash
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: bash_20250124
title: Type
type: string
required:
- name
- type
title: Bash-Tool (2025-01-24)
type: object
CodeExecutionTool_20250522:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: code_execution
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: code_execution_20250522
title: Type
type: string
required:
- name
- type
title: Code-Ausführungs-Tool (2025-05-22)
type: object
CodeExecutionTool_20250825:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: code_execution
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: code_execution_20250825
title: Type
type: string
required:
- name
- type
title: CodeExecutionTool_20250825
type: object
ComputerUseTool_20241022:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
display_height_px:
description: Die Höhe der Anzeige in Pixeln.
minimum: 1
title: Anzeigehöhe Px
type: integer
display_number:
anyOf:
- minimum: 0
type: integer
- type: 'null'
description: Die X11-Anzeigenummer (z. B. 0, 1) für die Anzeige.
title: Anzeigenummer
display_width_px:
description: Die Breite der Anzeige in Pixeln.
minimum: 1
title: Anzeigebreite Px
type: integer
name:
const: computer
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: computer_20241022
title: Type
type: string
required:
- display_height_px
- display_width_px
- name
- type
title: Computer-Nutzungs-Tool (2024-01-22)
type: object
MemoryTool_20250818:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: memory
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: memory_20250818
title: Type
type: string
required:
- name
- type
title: MemoryTool_20250818
type: object
ComputerUseTool_20250124:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
display_height_px:
description: Die Höhe der Anzeige in Pixeln.
minimum: 1
title: Anzeigehöhe Px
type: integer
display_number:
anyOf:
- minimum: 0
type: integer
- type: 'null'
description: Die X11-Anzeigenummer (z. B. 0, 1) für die Anzeige.
title: Anzeigenummer
display_width_px:
description: Die Breite der Anzeige in Pixeln.
minimum: 1
title: Anzeigebreite Px
type: integer
name:
const: computer
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: computer_20250124
title: Type
type: string
required:
- display_height_px
- display_width_px
- name
- type
title: Computer-Nutzungs-Tool (2025-01-24)
type: object
TextEditor_20241022:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: str_replace_editor
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: text_editor_20241022
title: Type
type: string
required:
- name
- type
title: Texteditor-Tool (2024-10-22)
type: object
TextEditor_20250124:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: str_replace_editor
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: text_editor_20250124
title: Type
type: string
required:
- name
- type
title: Texteditor-Tool (2025-01-24)
type: object
TextEditor_20250429:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
name:
const: str_replace_based_edit_tool
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: text_editor_20250429
title: Type
type: string
required:
- name
- type
title: Texteditor-Tool (2025-04-29)
type: object
TextEditor_20250728:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
max_characters:
anyOf:
- minimum: 1
type: integer
- type: 'null'
description: >-
Maximale Anzahl von Zeichen, die beim Anzeigen einer Datei
dargestellt werden. Wenn nicht angegeben, wird standardmäßig die
gesamte Datei angezeigt.
title: Maximale Zeichen
name:
const: str_replace_based_edit_tool
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: text_editor_20250728
title: Type
type: string
required:
- name
- type
title: TextEditor_20250728
type: object
WebSearchTool_20250305:
additionalProperties: false
properties:
allowed_domains:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Wenn angegeben, werden nur diese Domains in die Ergebnisse
aufgenommen. Kann nicht zusammen mit `blocked_domains` verwendet
werden.
title: Erlaubte Domains
blocked_domains:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Wenn angegeben, werden diese Domains niemals in den Ergebnissen
erscheinen. Kann nicht zusammen mit `allowed_domains` verwendet
werden.
title: Gesperrte Domains
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
max_uses:
anyOf:
- exclusiveMinimum: 0
type: integer
- type: 'null'
description: Maximale Anzahl der Verwendungen des Werkzeugs in der API-Anfrage.
title: Maximale Verwendungen
name:
const: web_search
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: web_search_20250305
title: Type
type: string
user_location:
anyOf:
- $ref: '#/components/schemas/UserLocation'
- type: 'null'
description: >-
Parameter für den Standort des Benutzers. Wird verwendet, um
relevantere Suchergebnisse bereitzustellen.
required:
- name
- type
title: Websuche-Tool (2025-03-05)
type: object
WebFetchTool_20250910:
additionalProperties: false
properties:
allowed_domains:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Liste der Domains, von denen abgerufen werden darf
title: Erlaubte Domains
blocked_domains:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Liste der Domains, von denen das Abrufen blockiert werden soll
title: Gesperrte Domains
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
citations:
anyOf:
- $ref: '#/components/schemas/RequestCitationsConfig'
- type: 'null'
description: >-
Zitierkonfiguration für abgerufene Dokumente. Zitate sind
standardmäßig deaktiviert.
max_content_tokens:
anyOf:
- exclusiveMinimum: 0
type: integer
- type: 'null'
description: >-
Maximale Anzahl von Tokens, die durch Einbeziehung von
Webseitentext-Inhalten im Kontext verwendet werden. Das Limit ist
ungefähr und gilt nicht für binäre Inhalte wie PDFs.
title: Maximale Inhalts-Token
max_uses:
anyOf:
- exclusiveMinimum: 0
type: integer
- type: 'null'
description: Maximale Anzahl der Verwendungen des Werkzeugs in der API-Anfrage.
title: Maximale Verwendungen
name:
const: web_fetch
description: >-
Name des Werkzeugs.
So wird das Werkzeug vom Modell und in `tool_use`-Blöcken
aufgerufen.
title: Name
type: string
type:
const: web_fetch_20250910
title: Type
type: string
required:
- name
- type
title: WebFetchTool_20250910
type: object
ResponseTextBlock:
properties:
citations:
anyOf:
- items:
discriminator:
mapping:
char_location:
$ref: '#/components/schemas/ResponseCharLocationCitation'
content_block_location:
$ref: >-
#/components/schemas/ResponseContentBlockLocationCitation
page_location:
$ref: '#/components/schemas/ResponsePageLocationCitation'
search_result_location:
$ref: >-
#/components/schemas/ResponseSearchResultLocationCitation
web_search_result_location:
$ref: >-
#/components/schemas/ResponseWebSearchResultLocationCitation
propertyName: type
oneOf:
- $ref: '#/components/schemas/ResponseCharLocationCitation'
- $ref: '#/components/schemas/ResponsePageLocationCitation'
- $ref: '#/components/schemas/ResponseContentBlockLocationCitation'
- $ref: >-
#/components/schemas/ResponseWebSearchResultLocationCitation
- $ref: '#/components/schemas/ResponseSearchResultLocationCitation'
type: array
- type: 'null'
default: null
description: >-
Zitate, die den Textblock unterstützen.
Der Typ des zurückgegebenen Zitats hängt vom Typ des zitierten
Dokuments ab. Das Zitieren eines PDFs ergibt `page_location`,
Klartext ergibt `char_location` und Inhaltsdokumente ergeben
`content_block_location`.
title: Citations
text:
maxLength: 5000000
minLength: 0
title: Text
type: string
type:
const: text
default: text
title: Type
type: string
required:
- citations
- text
- type
title: Text
type: object
ResponseThinkingBlock:
properties:
signature:
title: Signature
type: string
thinking:
title: Thinking
type: string
type:
const: thinking
default: thinking
title: Type
type: string
required:
- signature
- thinking
- type
title: Thinking
type: object
ResponseRedactedThinkingBlock:
properties:
data:
title: Data
type: string
type:
const: redacted_thinking
default: redacted_thinking
title: Type
type: string
required:
- data
- type
title: Geschwärztes Denken
type: object
ResponseToolUseBlock:
properties:
id:
pattern: ^[a-zA-Z0-9_-]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
minLength: 1
title: Name
type: string
type:
const: tool_use
default: tool_use
title: Type
type: string
required:
- id
- input
- name
- type
title: Tool use
type: object
ResponseServerToolUseBlock:
properties:
id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
enum:
- web_search
- web_fetch
- code_execution
- bash_code_execution
- text_editor_code_execution
title: Name
type: string
type:
const: server_tool_use
default: server_tool_use
title: Type
type: string
required:
- id
- input
- name
- type
title: Verwendung von Server-Tools
type: object
ResponseWebSearchToolResultBlock:
properties:
content:
anyOf:
- $ref: '#/components/schemas/ResponseWebSearchToolResultError'
- items:
$ref: '#/components/schemas/ResponseWebSearchResultBlock'
type: array
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: web_search_tool_result
default: web_search_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: Websuche-Tool-Ergebnis
type: object
ResponseWebFetchToolResultBlock:
properties:
content:
anyOf:
- $ref: '#/components/schemas/ResponseWebFetchToolResultError'
- $ref: '#/components/schemas/ResponseWebFetchResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: web_fetch_tool_result
default: web_fetch_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: ResponseWebFetchToolResultBlock
type: object
ResponseCodeExecutionToolResultBlock:
properties:
content:
anyOf:
- $ref: '#/components/schemas/ResponseCodeExecutionToolResultError'
- $ref: '#/components/schemas/ResponseCodeExecutionResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: code_execution_tool_result
default: code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: Code-Ausführungs-Tool-Ergebnis
type: object
ResponseBashCodeExecutionToolResultBlock:
properties:
content:
anyOf:
- $ref: '#/components/schemas/ResponseBashCodeExecutionToolResultError'
- $ref: '#/components/schemas/ResponseBashCodeExecutionResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: bash_code_execution_tool_result
default: bash_code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: ResponseBashCodeExecutionToolResultBlock
type: object
ResponseTextEditorCodeExecutionToolResultBlock:
properties:
content:
anyOf:
- $ref: >-
#/components/schemas/ResponseTextEditorCodeExecutionToolResultError
- $ref: >-
#/components/schemas/ResponseTextEditorCodeExecutionViewResultBlock
- $ref: >-
#/components/schemas/ResponseTextEditorCodeExecutionCreateResultBlock
- $ref: >-
#/components/schemas/ResponseTextEditorCodeExecutionStrReplaceResultBlock
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: text_editor_code_execution_tool_result
default: text_editor_code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: ResponseTextEditorCodeExecutionToolResultBlock
type: object
ResponseMCPToolUseBlock:
properties:
id:
pattern: ^[a-zA-Z0-9_-]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
description: Der Name des MCP-Werkzeugs
title: Name
type: string
server_name:
description: Der Name des MCP-Servers
title: Servername
type: string
type:
const: mcp_tool_use
default: mcp_tool_use
title: Type
type: string
required:
- id
- input
- name
- server_name
- type
title: MCP-Werkzeugverwendung
type: object
ResponseMCPToolResultBlock:
properties:
content:
anyOf:
- type: string
- items:
$ref: '#/components/schemas/ResponseTextBlock'
type: array
title: Content
is_error:
default: false
title: Ist Fehler
type: boolean
tool_use_id:
pattern: ^[a-zA-Z0-9_-]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: mcp_tool_result
default: mcp_tool_result
title: Type
type: string
required:
- content
- is_error
- tool_use_id
- type
title: MCP-Werkzeugergebnis
type: object
ResponseContainerUploadBlock:
description: Antwortmodell für eine in den Container hochgeladene Datei.
properties:
file_id:
title: Datei-ID
type: string
type:
const: container_upload
default: container_upload
title: Type
type: string
required:
- file_id
- type
title: Container-Upload
type: object
Usage:
properties:
cache_creation:
anyOf:
- $ref: '#/components/schemas/CacheCreation'
- type: 'null'
default: null
description: Aufschlüsselung der zwischengespeicherten Tokens nach TTL
cache_creation_input_tokens:
anyOf:
- minimum: 0
type: integer
- type: 'null'
default: null
description: >-
Die Anzahl der Eingabe-Tokens, die zum Erstellen des Cache-Eintrags
verwendet wurden.
examples:
- 2051
title: Cache-Erstellungs-Eingabe-Tokens
cache_read_input_tokens:
anyOf:
- minimum: 0
type: integer
- type: 'null'
default: null
description: Die Anzahl der aus dem Cache gelesenen Eingabe-Tokens.
examples:
- 2051
title: Cache-Lese-Eingabe-Tokens
input_tokens:
description: Die Anzahl der verwendeten Eingabe-Tokens.
examples:
- 2095
minimum: 0
title: Eingabe-Token
type: integer
output_tokens:
description: Die Anzahl der verwendeten Ausgabe-Tokens.
examples:
- 503
minimum: 0
title: Ausgabe-Token
type: integer
server_tool_use:
anyOf:
- $ref: '#/components/schemas/ServerToolUsage'
- type: 'null'
default: null
description: Die Anzahl der Server-Werkzeuganfragen.
service_tier:
anyOf:
- enum:
- standard
- priority
- batch
type: string
- type: 'null'
default: null
description: >-
Ob die Anfrage die Prioritäts-, Standard- oder Batch-Stufe verwendet
hat.
title: Dienststufe
required:
- cache_creation
- cache_creation_input_tokens
- cache_read_input_tokens
- input_tokens
- output_tokens
- server_tool_use
- service_tier
title: Usage
type: object
ResponseContextManagement:
properties:
applied_edits:
description: Liste der angewendeten Kontextverwaltungsänderungen.
items:
discriminator:
mapping:
clear_thinking_20251015:
$ref: '#/components/schemas/ResponseClearThinking20251015Edit'
clear_tool_uses_20250919:
$ref: '#/components/schemas/ResponseClearToolUses20250919Edit'
propertyName: type
oneOf:
- $ref: '#/components/schemas/ResponseClearToolUses20250919Edit'
- $ref: '#/components/schemas/ResponseClearThinking20251015Edit'
title: Angewendete Bearbeitungen
type: array
required:
- applied_edits
title: ResponseContextManagement
type: object
Container:
description: >-
Informationen über den Container, der in der Anfrage verwendet wird (für
das Code-Ausführungswerkzeug)
properties:
expires_at:
description: Der Zeitpunkt, zu dem der Container abläuft.
format: date-time
title: Läuft ab am
type: string
id:
description: Bezeichner für den in dieser Anfrage verwendeten Container
title: Id
type: string
skills:
anyOf:
- items:
$ref: '#/components/schemas/Skill'
type: array
- type: 'null'
default: null
description: Im Container geladene Skills
title: Skills
required:
- expires_at
- id
- skills
title: Container
type: object
RequestBashCodeExecutionToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- $ref: '#/components/schemas/RequestBashCodeExecutionToolResultError'
- $ref: '#/components/schemas/RequestBashCodeExecutionResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: bash_code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: RequestBashCodeExecutionToolResultBlock
type: object
RequestCodeExecutionToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- $ref: '#/components/schemas/RequestCodeExecutionToolResultError'
- $ref: '#/components/schemas/RequestCodeExecutionResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: Code-Ausführungs-Tool-Ergebnis
type: object
RequestContainerUploadBlock:
additionalProperties: false
description: >-
Ein Inhaltsblock, der eine Datei darstellt, die in den Container
hochgeladen werden soll.
Über diesen Block hochgeladene Dateien sind im Eingabeverzeichnis des
Containers verfügbar.
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
file_id:
title: Datei-ID
type: string
type:
const: container_upload
title: Type
type: string
required:
- file_id
- type
title: Container-Upload
type: object
RequestDocumentBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
citations:
anyOf:
- $ref: '#/components/schemas/RequestCitationsConfig'
- type: 'null'
context:
anyOf:
- minLength: 1
type: string
- type: 'null'
title: Context
source:
discriminator:
mapping:
base64:
$ref: '#/components/schemas/Base64PDFSource'
content:
$ref: '#/components/schemas/ContentBlockSource'
file:
$ref: '#/components/schemas/FileDocumentSource'
text:
$ref: '#/components/schemas/PlainTextSource'
propertyName: type
oneOf:
- $ref: '#/components/schemas/Base64PDFSource'
- $ref: '#/components/schemas/PlainTextSource'
- $ref: '#/components/schemas/ContentBlockSource'
- $ref: '#/components/schemas/FileDocumentSource'
title:
anyOf:
- maxLength: 500
minLength: 1
type: string
- type: 'null'
title: Title
type:
const: document
title: Type
type: string
required:
- source
- type
title: Document
type: object
RequestImageBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
source:
discriminator:
mapping:
base64:
$ref: '#/components/schemas/Base64ImageSource'
file:
$ref: '#/components/schemas/FileImageSource'
propertyName: type
oneOf:
- $ref: '#/components/schemas/Base64ImageSource'
- $ref: '#/components/schemas/FileImageSource'
title: Source
type:
const: image
title: Type
type: string
required:
- source
- type
title: Image
type: object
RequestMCPToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- type: string
- type: array
items:
$ref: '#/components/schemas/RequestTextBlock'
title: Content
is_error:
title: Ist Fehler
type: boolean
tool_use_id:
pattern: ^[a-zA-Z0-9_-]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: mcp_tool_result
title: Type
type: string
required:
- tool_use_id
- type
title: MCP-Werkzeugergebnis
type: object
RequestMCPToolUseBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
id:
pattern: ^[a-zA-Z0-9_-]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
title: Name
type: string
server_name:
description: Der Name des MCP-Servers
title: Servername
type: string
type:
const: mcp_tool_use
title: Type
type: string
required:
- id
- input
- name
- server_name
- type
title: MCP-Werkzeugverwendung
type: object
RequestRedactedThinkingBlock:
additionalProperties: false
properties:
data:
title: Data
type: string
type:
const: redacted_thinking
title: Type
type: string
required:
- data
- type
title: Geschwärztes Denken
type: object
RequestSearchResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
citations:
$ref: '#/components/schemas/RequestCitationsConfig'
content:
items:
$ref: '#/components/schemas/RequestTextBlock'
title: Content
type: array
source:
title: Source
type: string
title:
title: Title
type: string
type:
const: search_result
title: Type
type: string
required:
- content
- source
- title
- type
title: Suchergebnis
type: object
RequestServerToolUseBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
enum:
- web_search
- web_fetch
- code_execution
- bash_code_execution
- text_editor_code_execution
title: Name
type: string
type:
const: server_tool_use
title: Type
type: string
required:
- id
- input
- name
- type
title: Verwendung von Server-Tools
type: object
RequestTextEditorCodeExecutionToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- $ref: >-
#/components/schemas/RequestTextEditorCodeExecutionToolResultError
- $ref: >-
#/components/schemas/RequestTextEditorCodeExecutionViewResultBlock
- $ref: >-
#/components/schemas/RequestTextEditorCodeExecutionCreateResultBlock
- $ref: >-
#/components/schemas/RequestTextEditorCodeExecutionStrReplaceResultBlock
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: text_editor_code_execution_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: RequestTextEditorCodeExecutionToolResultBlock
type: object
RequestThinkingBlock:
additionalProperties: false
properties:
signature:
title: Signature
type: string
thinking:
title: Thinking
type: string
type:
const: thinking
title: Type
type: string
required:
- signature
- thinking
- type
title: Thinking
type: object
RequestToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- type: string
- items:
discriminator:
mapping:
document:
$ref: '#/components/schemas/RequestDocumentBlock'
image:
$ref: '#/components/schemas/RequestImageBlock'
search_result:
$ref: '#/components/schemas/RequestSearchResultBlock'
text:
$ref: '#/components/schemas/RequestTextBlock'
propertyName: type
oneOf:
- $ref: '#/components/schemas/RequestTextBlock'
- $ref: '#/components/schemas/RequestImageBlock'
- $ref: '#/components/schemas/RequestSearchResultBlock'
- $ref: '#/components/schemas/RequestDocumentBlock'
type: array
title: Content
is_error:
title: Ist Fehler
type: boolean
tool_use_id:
pattern: ^[a-zA-Z0-9_-]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: tool_result
title: Type
type: string
required:
- tool_use_id
- type
title: Werkzeugergebnis
type: object
RequestToolUseBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
id:
pattern: ^[a-zA-Z0-9_-]+$
title: Id
type: string
input:
additionalProperties: true
title: Input
type: object
name:
maxLength: 200
minLength: 1
title: Name
type: string
type:
const: tool_use
title: Type
type: string
required:
- id
- input
- name
- type
title: Tool use
type: object
RequestWebFetchToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- $ref: '#/components/schemas/RequestWebFetchToolResultError'
- $ref: '#/components/schemas/RequestWebFetchResultBlock'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: web_fetch_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: RequestWebFetchToolResultBlock
type: object
RequestWebSearchToolResultBlock:
additionalProperties: false
properties:
cache_control:
anyOf:
- discriminator:
mapping:
ephemeral:
$ref: '#/components/schemas/CacheControlEphemeral'
propertyName: type
oneOf:
- $ref: '#/components/schemas/CacheControlEphemeral'
- type: 'null'
description: Einen Cache-Kontroll-Haltepunkt an diesem Inhaltsblock erstellen.
title: Cache-Steuerung
content:
anyOf:
- items:
$ref: '#/components/schemas/RequestWebSearchResultBlock'
type: array
- $ref: '#/components/schemas/RequestWebSearchToolResultError'
title: Content
tool_use_id:
pattern: ^srvtoolu_[a-zA-Z0-9_]+$
title: Werkzeugverwendungs-ID
type: string
type:
const: web_search_tool_result
title: Type
type: string
required:
- content
- tool_use_id
- type
title: Websuche-Tool-Ergebnis
type: object
SkillParams:
additionalProperties: false
description: >-
Spezifikation für einen Skill, der in einem Container geladen werden
soll (Anfragemodell).
properties:
skill_id:
description: Skill-ID
maxLength: 64
minLength: 1
title: Skill-ID
type: string
type:
description: >-
Skill-Typ – entweder 'anthropic' (integriert) oder 'custom'
(benutzerdefiniert)
enum:
- anthropic
- custom
title: Type
type: string
version:
description: Skill-Version oder 'latest' für die neueste Version
maxLength: 64
minLength: 1
title: Version
type: string
required:
- skill_id
- type
title: SkillParams
type: object
ClearThinking20251015:
additionalProperties: false
properties:
keep:
anyOf:
- discriminator:
mapping:
all:
$ref: '#/components/schemas/AllThinkingTurns'
thinking_turns:
$ref: '#/components/schemas/ThinkingTurns'
propertyName: type
oneOf:
- $ref: '#/components/schemas/ThinkingTurns'
- $ref: '#/components/schemas/AllThinkingTurns'
- const: all
type: string
description: >-
Anzahl der neuesten Assistenten-Durchläufe, für die Denkblöcke
beibehalten werden sollen. Bei älteren Durchläufen werden die
Denkblöcke entfernt.
title: Keep
type:
const: clear_thinking_20251015
title: Type
type: string
required:
- type
title: ClearThinking20251015
type: object
ClearToolUses20250919:
additionalProperties: false
properties:
clear_at_least:
anyOf:
- $ref: '#/components/schemas/InputTokensClearAtLeast'
- type: 'null'
description: >-
Mindestanzahl von Token, die bei Auslösung gelöscht werden müssen.
Der Kontext wird nur geändert, wenn mindestens so viele Token
entfernt werden können.
clear_tool_inputs:
anyOf:
- type: boolean
- items:
type: string
type: array
- type: 'null'
description: >-
Ob alle Werkzeugeingaben gelöscht werden sollen (bool) oder
bestimmte Werkzeugeingaben zum Löschen (Liste)
title: Werkzeugeingaben löschen
exclude_tools:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: Werkzeugnamen, deren Verwendungen vom Löschen ausgenommen sind
title: Werkzeuge ausschließen
keep:
description: Anzahl der beizubehaltenden Werkzeugverwendungen in der Konversation
discriminator:
mapping:
tool_uses:
$ref: '#/components/schemas/ToolUsesKeep'
propertyName: type
oneOf:
- $ref: '#/components/schemas/ToolUsesKeep'
title: Keep
trigger:
description: Bedingung, die die Kontextverwaltungsstrategie auslöst
discriminator:
mapping:
input_tokens:
$ref: '#/components/schemas/InputTokensTrigger'
tool_uses:
$ref: '#/components/schemas/ToolUsesTrigger'
propertyName: type
oneOf:
- $ref: '#/components/schemas/InputTokensTrigger'
- $ref: '#/components/schemas/ToolUsesTrigger'
title: Trigger
type:
const: clear_tool_uses_20250919
title: Type
type: string
required:
- type
title: ClearToolUses20250919
type: object
RequestMCPServerToolConfiguration:
additionalProperties: false
properties:
allowed_tools:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Erlaubte Werkzeuge
enabled:
anyOf:
- type: boolean
- type: 'null'
title: Enabled
title: RequestMCPServerToolConfiguration
type: object
JSONOutputFormat:
additionalProperties: false
properties:
schema:
description: JSON-Schema zur Definition der Claude-Ausgabe.
type: object
type:
const: json_schema
title: Type
type: string
required:
- schema
- type
title: JSONOutputFormat
type: object
TokenTaskBudget:
additionalProperties: false
properties:
remaining:
description: Verbleibendes Token-Budget.
minimum: 0
title: Remaining
type: integer
total:
description: Gesamtes Token-Budget über Kontexte hinweg.
minimum: 20000
title: Total
type: integer
type:
const: tokens
title: Type
type: string
required:
- total
- type
title: TokenTaskBudget
type: object
CacheControlEphemeral:
additionalProperties: false
properties:
type:
const: ephemeral
title: Type
type: string
required:
- type
title: CacheControlEphemeral
type: object
RequestCharLocationCitation:
additionalProperties: false
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
title: Dokumenttitel
end_char_index:
title: End-Zeichen-Index
type: integer
start_char_index:
minimum: 0
title: Start-Zeichen-Index
type: integer
type:
const: char_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_char_index
- start_char_index
- type
title: Charakterposition
type: object
RequestContentBlockLocationCitation:
additionalProperties: false
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
title: Dokumenttitel
end_block_index:
title: End-Block-Index
type: integer
start_block_index:
minimum: 0
title: Start-Block-Index
type: integer
type:
const: content_block_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_block_index
- start_block_index
- type
title: Inhaltsblock-Position
type: object
RequestPageLocationCitation:
additionalProperties: false
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
title: Dokumenttitel
end_page_number:
title: End-Seitennummer
type: integer
start_page_number:
minimum: 1
title: Startseitennummer
type: integer
type:
const: page_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_page_number
- start_page_number
- type
title: Seitenposition
type: object
RequestSearchResultLocationCitation:
additionalProperties: false
properties:
cited_text:
title: Zitierter Text
type: string
end_block_index:
title: End-Block-Index
type: integer
search_result_index:
minimum: 0
title: Suchergebnis-Index
type: integer
source:
title: Source
type: string
start_block_index:
minimum: 0
title: Start-Block-Index
type: integer
title:
anyOf:
- type: string
- type: 'null'
title: Title
type:
const: search_result_location
title: Type
type: string
required:
- cited_text
- end_block_index
- search_result_index
- source
- start_block_index
- title
- type
title: RequestSearchResultLocationCitation
type: object
RequestWebSearchResultLocationCitation:
additionalProperties: false
properties:
cited_text:
title: Zitierter Text
type: string
encrypted_index:
title: Verschlüsselter Index
type: string
title:
anyOf:
- maxLength: 512
minLength: 1
type: string
- type: 'null'
title: Title
type:
const: web_search_result_location
title: Type
type: string
url:
maxLength: 2048
minLength: 1
title: Url
type: string
required:
- cited_text
- encrypted_index
- title
- type
- url
title: RequestWebSearchResultLocationCitation
type: object
InputSchema:
additionalProperties: true
properties:
properties:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Properties
required:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Required
type:
const: object
title: Type
type: string
required:
- type
title: InputSchema
type: object
UserLocation:
additionalProperties: false
properties:
city:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
description: Die Stadt des Benutzers.
examples:
- New York
- Tokyo
- Los Angeles
title: City
country:
anyOf:
- maxLength: 2
minLength: 2
type: string
- type: 'null'
description: >-
Der zweistellige
[ISO-Ländercode](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
des Benutzers.
examples:
- US
- JP
- GB
title: Country
region:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
description: Die Region des Benutzers.
examples:
- California
- Ontario
- Wales
title: Region
timezone:
anyOf:
- maxLength: 255
minLength: 1
type: string
- type: 'null'
description: Die [IANA-Zeitzone](https://nodatime.org/TimeZones) des Benutzers.
examples:
- America/New_York
- Asia/Tokyo
- Europe/London
title: Timezone
type:
const: approximate
title: Type
type: string
required:
- type
title: UserLocation
type: object
RequestCitationsConfig:
additionalProperties: false
properties:
enabled:
title: Enabled
type: boolean
title: RequestCitationsConfig
type: object
ResponseCharLocationCitation:
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- type: string
- type: 'null'
title: Dokumenttitel
end_char_index:
title: End-Zeichen-Index
type: integer
file_id:
anyOf:
- type: string
- type: 'null'
default: null
title: Datei-ID
start_char_index:
minimum: 0
title: Start-Zeichen-Index
type: integer
type:
const: char_location
default: char_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_char_index
- file_id
- start_char_index
- type
title: Charakterposition
type: object
ResponseContentBlockLocationCitation:
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- type: string
- type: 'null'
title: Dokumenttitel
end_block_index:
title: End-Block-Index
type: integer
file_id:
anyOf:
- type: string
- type: 'null'
default: null
title: Datei-ID
start_block_index:
minimum: 0
title: Start-Block-Index
type: integer
type:
const: content_block_location
default: content_block_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_block_index
- file_id
- start_block_index
- type
title: Inhaltsblock-Position
type: object
ResponsePageLocationCitation:
properties:
cited_text:
title: Zitierter Text
type: string
document_index:
minimum: 0
title: Dokumentindex
type: integer
document_title:
anyOf:
- type: string
- type: 'null'
title: Dokumenttitel
end_page_number:
title: End-Seitennummer
type: integer
file_id:
anyOf:
- type: string
- type: 'null'
default: null
title: Datei-ID
start_page_number:
minimum: 1
title: Startseitennummer
type: integer
type:
const: page_location
default: page_location
title: Type
type: string
required:
- cited_text
- document_index
- document_title
- end_page_number
- file_id
- start_page_number
- type
title: Seitenposition
type: object
ResponseSearchResultLocationCitation:
properties:
cited_text:
title: Zitierter Text
type: string
end_block_index:
title: End-Block-Index
type: integer
search_result_index:
minimum: 0
title: Suchergebnis-Index
type: integer
source:
title: Source
type: string
start_block_index:
minimum: 0
title: Start-Block-Index
type: integer
title:
anyOf:
- type: string
- type: 'null'
title: Title
type:
const: search_result_location
default: search_result_location
title: Type
type: string
required:
- cited_text
- end_block_index
- search_result_index
- source
- start_block_index
- title
- type
title: ResponseSearchResultLocationCitation
type: object
ResponseWebSearchResultLocationCitation:
properties:
cited_text:
title: Zitierter Text
type: string
encrypted_index:
title: Verschlüsselter Index
type: string
title:
anyOf:
- maxLength: 512
type: string
- type: 'null'
title: Title
type:
const: web_search_result_location
default: web_search_result_location
title: Type
type: string
url:
title: Url
type: string
required:
- cited_text
- encrypted_index
- title
- type
- url
title: ResponseWebSearchResultLocationCitation
type: object
ResponseWebSearchToolResultError:
properties:
error_code:
$ref: '#/components/schemas/WebSearchToolResultErrorCode'
type:
const: web_search_tool_result_error
default: web_search_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: ResponseWebSearchToolResultError
type: object
ResponseWebSearchResultBlock:
properties:
encrypted_content:
title: Verschlüsselter Inhalt
type: string
page_age:
anyOf:
- type: string
- type: 'null'
default: null
title: Seitenalter
title:
title: Title
type: string
type:
const: web_search_result
default: web_search_result
title: Type
type: string
url:
title: Url
type: string
required:
- encrypted_content
- page_age
- title
- type
- url
title: ResponseWebSearchResultBlock
type: object
ResponseWebFetchToolResultError:
properties:
error_code:
$ref: '#/components/schemas/WebFetchToolResultErrorCode'
type:
const: web_fetch_tool_result_error
default: web_fetch_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: ResponseWebFetchToolResultError
type: object
ResponseWebFetchResultBlock:
properties:
content:
$ref: '#/components/schemas/ResponseDocumentBlock'
retrieved_at:
anyOf:
- type: string
- type: 'null'
default: null
description: ISO 8601-Zeitstempel, wann der Inhalt abgerufen wurde
title: Abgerufen am
type:
const: web_fetch_result
default: web_fetch_result
title: Type
type: string
url:
description: URL des abgerufenen Inhalts
title: Url
type: string
required:
- content
- retrieved_at
- type
- url
title: ResponseWebFetchResultBlock
type: object
ResponseCodeExecutionToolResultError:
properties:
error_code:
$ref: '#/components/schemas/CodeExecutionToolResultErrorCode'
type:
const: code_execution_tool_result_error
default: code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: Code-Ausführungs-Tool-Fehler
type: object
ResponseCodeExecutionResultBlock:
properties:
content:
items:
$ref: '#/components/schemas/ResponseCodeExecutionOutputBlock'
title: Content
type: array
return_code:
title: Rückgabecode
type: integer
stderr:
title: Stderr
type: string
stdout:
title: Stdout
type: string
type:
const: code_execution_result
default: code_execution_result
title: Type
type: string
required:
- content
- return_code
- stderr
- stdout
- type
title: Code-Ausführungsergebnis
type: object
ResponseBashCodeExecutionToolResultError:
properties:
error_code:
$ref: '#/components/schemas/BashCodeExecutionToolResultErrorCode'
type:
const: bash_code_execution_tool_result_error
default: bash_code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: ResponseBashCodeExecutionToolResultError
type: object
ResponseBashCodeExecutionResultBlock:
properties:
content:
items:
$ref: '#/components/schemas/ResponseBashCodeExecutionOutputBlock'
title: Content
type: array
return_code:
title: Rückgabecode
type: integer
stderr:
title: Stderr
type: string
stdout:
title: Stdout
type: string
type:
const: bash_code_execution_result
default: bash_code_execution_result
title: Type
type: string
required:
- content
- return_code
- stderr
- stdout
- type
title: ResponseBashCodeExecutionResultBlock
type: object
ResponseTextEditorCodeExecutionToolResultError:
properties:
error_code:
$ref: '#/components/schemas/TextEditorCodeExecutionToolResultErrorCode'
error_message:
anyOf:
- type: string
- type: 'null'
default: null
title: Fehlermeldung
type:
const: text_editor_code_execution_tool_result_error
default: text_editor_code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- error_message
- type
title: ResponseTextEditorCodeExecutionToolResultError
type: object
ResponseTextEditorCodeExecutionViewResultBlock:
properties:
content:
title: Content
type: string
file_type:
enum:
- text
- image
- pdf
title: Dateityp
type: string
num_lines:
anyOf:
- type: integer
- type: 'null'
default: null
title: Anzahl der Zeilen
start_line:
anyOf:
- type: integer
- type: 'null'
default: null
title: Startzeile
total_lines:
anyOf:
- type: integer
- type: 'null'
default: null
title: Gesamtzeilen
type:
const: text_editor_code_execution_view_result
default: text_editor_code_execution_view_result
title: Type
type: string
required:
- content
- file_type
- num_lines
- start_line
- total_lines
- type
title: ResponseTextEditorCodeExecutionViewResultBlock
type: object
ResponseTextEditorCodeExecutionCreateResultBlock:
properties:
is_file_update:
title: Ist Dateiaktualisierung
type: boolean
type:
const: text_editor_code_execution_create_result
default: text_editor_code_execution_create_result
title: Type
type: string
required:
- is_file_update
- type
title: ResponseTextEditorCodeExecutionCreateResultBlock
type: object
ResponseTextEditorCodeExecutionStrReplaceResultBlock:
properties:
lines:
anyOf:
- items:
type: string
type: array
- type: 'null'
default: null
title: Lines
new_lines:
anyOf:
- type: integer
- type: 'null'
default: null
title: Neue Zeilen
new_start:
anyOf:
- type: integer
- type: 'null'
default: null
title: Neuer Start
old_lines:
anyOf:
- type: integer
- type: 'null'
default: null
title: Alte Zeilen
old_start:
anyOf:
- type: integer
- type: 'null'
default: null
title: Alter Start
type:
const: text_editor_code_execution_str_replace_result
default: text_editor_code_execution_str_replace_result
title: Type
type: string
required:
- lines
- new_lines
- new_start
- old_lines
- old_start
- type
title: ResponseTextEditorCodeExecutionStrReplaceResultBlock
type: object
CacheCreation:
properties:
ephemeral_1h_input_tokens:
default: 0
description: >-
Die Anzahl der Eingabe-Token, die zum Erstellen des
1-Stunden-Cache-Eintrags verwendet wurden.
minimum: 0
title: Kurzlebige 1H-Eingabe-Tokens
type: integer
ephemeral_5m_input_tokens:
default: 0
description: >-
Die Anzahl der Eingabe-Token, die zum Erstellen des
5-Minuten-Cache-Eintrags verwendet wurden.
minimum: 0
title: Kurzlebige 5M-Eingabe-Tokens
type: integer
required:
- ephemeral_1h_input_tokens
- ephemeral_5m_input_tokens
title: CacheCreation
type: object
ServerToolUsage:
properties:
web_fetch_requests:
default: 0
description: Die Anzahl der Web-Fetch-Werkzeuganfragen.
examples:
- 2
minimum: 0
title: Web-Abrufanfragen
type: integer
web_search_requests:
default: 0
description: Die Anzahl der Web-Such-Werkzeuganfragen.
examples:
- 0
minimum: 0
title: Websuchanfragen
type: integer
required:
- web_fetch_requests
- web_search_requests
title: ServerToolUsage
type: object
ResponseClearThinking20251015Edit:
properties:
cleared_input_tokens:
description: Anzahl der durch diese Bearbeitung gelöschten Eingabe-Tokens.
minimum: 0
title: Gelöschte Eingabe-Tokens
type: integer
cleared_thinking_turns:
description: Anzahl der gelöschten Denkrunden.
minimum: 0
title: Gelöschte Denk-Runden
type: integer
type:
const: clear_thinking_20251015
default: clear_thinking_20251015
description: Der Typ der angewendeten Kontextverwaltungsänderung.
title: Type
type: string
required:
- cleared_input_tokens
- cleared_thinking_turns
- type
title: ResponseClearThinking20251015Edit
type: object
ResponseClearToolUses20250919Edit:
properties:
cleared_input_tokens:
description: Anzahl der durch diese Bearbeitung gelöschten Eingabe-Tokens.
minimum: 0
title: Gelöschte Eingabe-Tokens
type: integer
cleared_tool_uses:
description: Anzahl der gelöschten Werkzeugverwendungen.
minimum: 0
title: Gelöschte Werkzeugverwendungen
type: integer
type:
const: clear_tool_uses_20250919
default: clear_tool_uses_20250919
description: Der Typ der angewendeten Kontextverwaltungsänderung.
title: Type
type: string
required:
- cleared_input_tokens
- cleared_tool_uses
- type
title: ResponseClearToolUses20250919Edit
type: object
Skill:
description: Ein Skill, der in einem Container geladen wurde (Antwortmodell).
properties:
skill_id:
description: Skill-ID
maxLength: 64
minLength: 1
title: Skill-ID
type: string
type:
description: >-
Skill-Typ – entweder 'anthropic' (integriert) oder 'custom'
(benutzerdefiniert)
enum:
- anthropic
- custom
title: Type
type: string
version:
description: Skill-Version oder 'latest' für die neueste Version
maxLength: 64
minLength: 1
title: Version
type: string
required:
- skill_id
- type
- version
title: Skill
type: object
RequestBashCodeExecutionToolResultError:
additionalProperties: false
properties:
error_code:
$ref: '#/components/schemas/BashCodeExecutionToolResultErrorCode'
type:
const: bash_code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: RequestBashCodeExecutionToolResultError
type: object
RequestBashCodeExecutionResultBlock:
additionalProperties: false
properties:
content:
items:
$ref: '#/components/schemas/RequestBashCodeExecutionOutputBlock'
title: Content
type: array
return_code:
title: Rückgabecode
type: integer
stderr:
title: Stderr
type: string
stdout:
title: Stdout
type: string
type:
const: bash_code_execution_result
title: Type
type: string
required:
- content
- return_code
- stderr
- stdout
- type
title: RequestBashCodeExecutionResultBlock
type: object
RequestCodeExecutionToolResultError:
additionalProperties: false
properties:
error_code:
$ref: '#/components/schemas/CodeExecutionToolResultErrorCode'
type:
const: code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: Code-Ausführungs-Tool-Fehler
type: object
RequestCodeExecutionResultBlock:
additionalProperties: false
properties:
content:
items:
$ref: '#/components/schemas/RequestCodeExecutionOutputBlock'
title: Content
type: array
return_code:
title: Rückgabecode
type: integer
stderr:
title: Stderr
type: string
stdout:
title: Stdout
type: string
type:
const: code_execution_result
title: Type
type: string
required:
- content
- return_code
- stderr
- stdout
- type
title: Code-Ausführungsergebnis
type: object
Base64PDFSource:
additionalProperties: false
properties:
data:
format: byte
title: Data
type: string
media_type:
const: application/pdf
title: Medientyp
type: string
type:
const: base64
title: Type
type: string
required:
- data
- media_type
- type
title: PDF (base64)
type: object
ContentBlockSource:
additionalProperties: false
properties:
content:
anyOf:
- type: string
- items:
discriminator:
mapping:
image:
$ref: '#/components/schemas/RequestImageBlock'
text:
$ref: '#/components/schemas/RequestTextBlock'
propertyName: type
oneOf:
- $ref: '#/components/schemas/RequestTextBlock'
- $ref: '#/components/schemas/RequestImageBlock'
type: array
title: Content
type:
const: content
title: Type
type: string
required:
- content
- type
title: Inhaltsblock
type: object
FileDocumentSource:
additionalProperties: false
properties:
file_id:
title: Datei-ID
type: string
type:
const: file
title: Type
type: string
required:
- file_id
- type
title: Dateidokument
type: object
PlainTextSource:
additionalProperties: false
properties:
data:
title: Data
type: string
media_type:
const: text/plain
title: Medientyp
type: string
type:
const: text
title: Type
type: string
required:
- data
- media_type
- type
title: Klartext
type: object
Base64ImageSource:
additionalProperties: false
properties:
data:
format: byte
title: Data
type: string
media_type:
enum:
- image/jpeg
- image/png
- image/gif
- image/webp
title: Medientyp
type: string
type:
const: base64
title: Type
type: string
required:
- data
- media_type
- type
title: Base64ImageSource
type: object
FileImageSource:
additionalProperties: false
properties:
file_id:
title: Datei-ID
type: string
type:
const: file
title: Type
type: string
required:
- file_id
- type
title: FileImageSource
type: object
RequestTextEditorCodeExecutionToolResultError:
additionalProperties: false
properties:
error_code:
$ref: '#/components/schemas/TextEditorCodeExecutionToolResultErrorCode'
error_message:
anyOf:
- type: string
- type: 'null'
title: Fehlermeldung
type:
const: text_editor_code_execution_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: RequestTextEditorCodeExecutionToolResultError
type: object
RequestTextEditorCodeExecutionViewResultBlock:
additionalProperties: false
properties:
content:
title: Content
type: string
file_type:
enum:
- text
- image
- pdf
title: Dateityp
type: string
num_lines:
anyOf:
- type: integer
- type: 'null'
title: Anzahl der Zeilen
start_line:
anyOf:
- type: integer
- type: 'null'
title: Startzeile
total_lines:
anyOf:
- type: integer
- type: 'null'
title: Gesamtzeilen
type:
const: text_editor_code_execution_view_result
title: Type
type: string
required:
- content
- file_type
- type
title: RequestTextEditorCodeExecutionViewResultBlock
type: object
RequestTextEditorCodeExecutionCreateResultBlock:
additionalProperties: false
properties:
is_file_update:
title: Ist Dateiaktualisierung
type: boolean
type:
const: text_editor_code_execution_create_result
title: Type
type: string
required:
- is_file_update
- type
title: RequestTextEditorCodeExecutionCreateResultBlock
type: object
RequestTextEditorCodeExecutionStrReplaceResultBlock:
additionalProperties: false
properties:
lines:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Lines
new_lines:
anyOf:
- type: integer
- type: 'null'
title: Neue Zeilen
new_start:
anyOf:
- type: integer
- type: 'null'
title: Neuer Start
old_lines:
anyOf:
- type: integer
- type: 'null'
title: Alte Zeilen
old_start:
anyOf:
- type: integer
- type: 'null'
title: Alter Start
type:
const: text_editor_code_execution_str_replace_result
title: Type
type: string
required:
- type
title: RequestTextEditorCodeExecutionStrReplaceResultBlock
type: object
RequestWebFetchToolResultError:
additionalProperties: false
properties:
error_code:
$ref: '#/components/schemas/WebFetchToolResultErrorCode'
type:
const: web_fetch_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: RequestWebFetchToolResultError
type: object
RequestWebFetchResultBlock:
additionalProperties: false
properties:
content:
$ref: '#/components/schemas/RequestDocumentBlock'
retrieved_at:
anyOf:
- type: string
- type: 'null'
description: ISO 8601-Zeitstempel, wann der Inhalt abgerufen wurde
title: Abgerufen am
type:
const: web_fetch_result
title: Type
type: string
url:
description: URL des abgerufenen Inhalts
title: Url
type: string
required:
- content
- type
- url
title: RequestWebFetchResultBlock
type: object
RequestWebSearchResultBlock:
additionalProperties: false
properties:
encrypted_content:
title: Verschlüsselter Inhalt
type: string
page_age:
anyOf:
- type: string
- type: 'null'
title: Seitenalter
title:
title: Title
type: string
type:
const: web_search_result
title: Type
type: string
url:
title: Url
type: string
required:
- encrypted_content
- title
- type
- url
title: RequestWebSearchResultBlock
type: object
RequestWebSearchToolResultError:
additionalProperties: false
properties:
error_code:
$ref: '#/components/schemas/WebSearchToolResultErrorCode'
type:
const: web_search_tool_result_error
title: Type
type: string
required:
- error_code
- type
title: RequestWebSearchToolResultError
type: object
AllThinkingTurns:
additionalProperties: false
properties:
type:
const: all
title: Type
type: string
required:
- type
title: AllThinkingTurns
type: object
ThinkingTurns:
additionalProperties: false
properties:
type:
const: thinking_turns
title: Type
type: string
value:
minimum: 1
title: Value
type: integer
required:
- type
- value
title: ThinkingTurns
type: object
InputTokensClearAtLeast:
additionalProperties: false
properties:
type:
const: input_tokens
title: Type
type: string
value:
minimum: 0
title: Value
type: integer
required:
- type
- value
title: InputTokensClearAtLeast
type: object
ToolUsesKeep:
additionalProperties: false
properties:
type:
const: tool_uses
title: Type
type: string
value:
minimum: 0
title: Value
type: integer
required:
- type
- value
title: ToolUsesKeep
type: object
InputTokensTrigger:
additionalProperties: false
properties:
type:
const: input_tokens
title: Type
type: string
value:
minimum: 1
title: Value
type: integer
required:
- type
- value
title: InputTokensTrigger
type: object
ToolUsesTrigger:
additionalProperties: false
properties:
type:
const: tool_uses
title: Type
type: string
value:
minimum: 1
title: Value
type: integer
required:
- type
- value
title: ToolUsesTrigger
type: object
WebSearchToolResultErrorCode:
enum:
- invalid_tool_input
- unavailable
- max_uses_exceeded
- too_many_requests
- query_too_long
title: WebSearchToolResultErrorCode
type: string
WebFetchToolResultErrorCode:
enum:
- invalid_tool_input
- url_too_long
- url_not_allowed
- url_not_accessible
- unsupported_content_type
- too_many_requests
- max_uses_exceeded
- unavailable
title: WebFetchToolResultErrorCode
type: string
ResponseDocumentBlock:
properties:
citations:
anyOf:
- $ref: '#/components/schemas/ResponseCitationsConfig'
- type: 'null'
default: null
description: Zitierkonfiguration für das Dokument
source:
discriminator:
mapping:
base64:
$ref: '#/components/schemas/Base64PDFSource'
text:
$ref: '#/components/schemas/PlainTextSource'
propertyName: type
oneOf:
- $ref: '#/components/schemas/Base64PDFSource'
- $ref: '#/components/schemas/PlainTextSource'
title: Source
title:
anyOf:
- type: string
- type: 'null'
default: null
description: Der Titel des Dokuments
title: Title
type:
const: document
default: document
title: Type
type: string
required:
- citations
- source
- title
- type
title: ResponseDocumentBlock
type: object
CodeExecutionToolResultErrorCode:
enum:
- invalid_tool_input
- unavailable
- too_many_requests
- execution_time_exceeded
title: CodeExecutionToolResultErrorCode
type: string
ResponseCodeExecutionOutputBlock:
properties:
file_id:
title: Datei-ID
type: string
type:
const: code_execution_output
default: code_execution_output
title: Type
type: string
required:
- file_id
- type
title: ResponseCodeExecutionOutputBlock
type: object
BashCodeExecutionToolResultErrorCode:
enum:
- invalid_tool_input
- unavailable
- too_many_requests
- execution_time_exceeded
- output_file_too_large
title: BashCodeExecutionToolResultErrorCode
type: string
ResponseBashCodeExecutionOutputBlock:
properties:
file_id:
title: Datei-ID
type: string
type:
const: bash_code_execution_output
default: bash_code_execution_output
title: Type
type: string
required:
- file_id
- type
title: ResponseBashCodeExecutionOutputBlock
type: object
TextEditorCodeExecutionToolResultErrorCode:
enum:
- invalid_tool_input
- unavailable
- too_many_requests
- execution_time_exceeded
- file_not_found
title: TextEditorCodeExecutionToolResultErrorCode
type: string
RequestBashCodeExecutionOutputBlock:
additionalProperties: false
properties:
file_id:
title: Datei-ID
type: string
type:
const: bash_code_execution_output
title: Type
type: string
required:
- file_id
- type
title: RequestBashCodeExecutionOutputBlock
type: object
RequestCodeExecutionOutputBlock:
additionalProperties: false
properties:
file_id:
title: Datei-ID
type: string
type:
const: code_execution_output
title: Type
type: string
required:
- file_id
- type
title: RequestCodeExecutionOutputBlock
type: object
ResponseCitationsConfig:
properties:
enabled:
default: false
title: Enabled
type: boolean
required:
- enabled
title: ResponseCitationsConfig
type: object
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
##Alle APIs erfordern Bearer-Token-Authentifizierung##
**API-Schlüssel erhalten:**
Besuchen Sie die
[API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um
Ihren API-Schlüssel zu erhalten
**Zum Anfrage-Header hinzufügen:**
```
Authorization: Bearer YOUR_API_KEY
```
````