Anforderung und Antwort

Der Anfragetext wird im body Feld einer Anfrage an InvokeModeloder übergeben InvokeModelWithResponseStream. Die maximale Größe der Nutzdaten, die Sie in einer Anfrage senden können, beträgt 20 MB.

Weitere Informationen finden Sie unter https://docs.anthropic.com/claude/reference/messages_post.

Warnung

Claude Sonnet 4.5 und Claude Haiku 4.5 unterstützen nur die Angabe eines der Parameter temperature oder top_p, können aber nicht beide verarbeiten. Dies gilt nicht für ältere Modelle.

Request

Anthropic Claude verfügt über die folgenden Inferenzparameter für Nachrichten-Inferenzaufrufe.


{
    "anthropic_version": "bedrock-2023-05-31", 
    "anthropic_beta": ["computer-use-2024-10-22"] 
    "max_tokens": int,
    "system": string,    
    "messages": [
        {
            "role": string,
            "content": [
                { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "content image bytes" } },
                { "type": "text", "text": "content text" }
      ]
        }
    ],
    "temperature": float,
    "top_p": float,
    "top_k": int,
    "tools": [
        {
                "type": "custom",
                "name": string,
                "description": string,
                "input_schema": json
            
        },
        { 
            "type": "computer_20241022",  
            "name": "computer", 
            "display_height_px": int,
            "display_width_px": int,
            "display_number": 0 int
        },
        { 
            "type": "bash_20241022", 
            "name": "bash"
        },
        { 
            "type": "text_editor_20241022",
            "name": "str_replace_editor"
        }
        
    ],
    "tool_choice": {
        "type" :  string,
        "name" : string,
    },
    

 
    "stop_sequences": [string]
}

Die folgenden Parameter sind erforderlich.

anthropic_version – (erforderlich) Die anthropische Version Der Wert muss sein. bedrock-2023-05-31
max_tokens – (erforderlich) Die maximale Anzahl von Token, die vor dem Stoppen generiert werden sollen.

Beachten Sie, dass Anthropic-Claude-Modelle möglicherweise die Generierung von Token einstellen, bevor der Wert von max_tokens erreicht ist. Verschiedene Anthropic-Claude-Modelle haben unterschiedliche Maximalwerte für diesen Parameter. Weitere Informationen finden Sie unter Modellvergleich.

messages – (erforderlich) Die Eingabenachrichten

role – Die Rolle der Konversationsrunde Gültige Werte sind user und assistant.

Minimum	Maximum
0	2000

content – (erforderlich) Der Inhalt der Konversationsrunde als Array von Objekten. Jedes Objekt enthält ein type-Feld, in dem Sie einen der folgenden Werte angeben können:
- text – Wenn Sie diesen Typ angeben, müssen Sie ein text-Feld einschließen und den Text-Prompt als Wert angeben. Wenn es sich bei einem anderen Objekt im Array um ein Bild handelt, gilt dieser Text-Prompt für die Bilder.
- image – Wenn Sie diesen Typ angeben, müssen Sie ein source-Feld angeben, das einem Objekt mit den folgenden Feldern zugeordnet ist:
  - type – (erforderlich) Der Kodierungstyp für das Bild. Sie können base64 angeben.
  - media_type – (erforderlich) Der Typ des Bildes. Sie können die folgenden Bildformate angeben.
    
    image/jpeg
    
    image/png
    
    image/webp
    
    image/gif
  - data – (erforderlich) Die base64-codierten Bildbytes für das Bild. Die maximale Größe ist 3,75 MB. Die maximale Höhe und Breite eines Bildes beträgt 8 000 Pixel.

Die folgenden Parameter sind optional.

system – (optional) Der System-Prompt für die Anfrage.

Ein System-Prompt bietet die Möglichkeit, Anthropic Claude mit Kontext und Anweisungen zu versorgen, beispielsweise durch die Angabe eines bestimmten Ziels oder einer bestimmten Rolle. Weitere Informationen finden Sie unter System-Prompts in der Anthropic-Dokumentation.

Anmerkung
Sie können System-Prompts mit Anthropic Claude Version 2.1 oder höher verwenden.

anthropic_beta – (optional) Der anthropische Beta-Parameter ist eine Liste von Zeichenfolgen von Beta-Headern, die verwendet werden, um anzugeben, dass Sie sich für einen bestimmten Satz von Beta-Features entschieden haben.

Anmerkung

Die Variante mit einer Länge von 1 Million Token Claude Sonnet 4 steht Ihnen in ausgewählten AWS Regionen als „Beta-Service“ zur Verfügung, wie in den AWS Servicebedingungen definiert. Sie unterliegt Ihrer Vereinbarung mit AWS und den AWS Servicebedingungen sowie der geltenden Muster-EULA. Weitere Informationen zu den Preisen für längere Kontextanfragen finden Sie auf der Seite Amazon Bedrock – Preise. Es gelten separate Service Quotas (weitere Informationen finden Sie unter Servicekontingenten imAWS-Managementkonsole).

Verfügbare Beta-Header sind beispielsweise folgende:

Beta-Feature	Beta-Header	Hinweise
Computer Use	`computer-use-2025-01-24`	Kompatibel mit Claude 3.7 Sonnet.
Verwendung des Tools	`token-efficient-tools-2025-02-19`	Kompatibel mit Claude 3.7 Sonnet und Claude 4+.
Verschachteltes Denken	`Interleaved-thinking-2025-05-14`	Kompatibel mit Modellen von Claude 4+.
Ermöglicht bis zu 128 000 Ausgabetoken	`output-128k-2025-02-19`	Kompatibel mit Claude 3.7 Sonnet.
Entwicklermodus für Raw Thinking bei Modellen von Claude 4+	`dev-full-thinking-2025-05-14`	Kompatibel nur mit Modellen von Claude 4+. Wenden Sie sich an Ihr Kontoteam, um auf diese Betaversion zuzugreifen.
1 Mio. Token	`context-1m-2025-08-07`	Kompatibel mit Claude Sonnet 4
Kontextverwaltung	`context-management-2025-06-27`	Kompatibel mit Claude Sonnet 4.5 und Claude Haiku 4.5
Aufwand	`effort-2025-11-24`	Kompatibel mit Claude Opus 4.5
Tool zur Werkzeugsuche	`tool-search-tool-2025-10-19`	Kompatibel mit Claude Opus 4.5
Beispiele für die Verwendung von Tools	`tool-examples-2025-10-29`	Kompatibel mit Claude Opus 4.5

stop_sequences – (optional) Benutzerdefinierte Textsequenzen, die dazu führen, dass das Modell nicht mehr generiert wird. Anthropic-Claude-Modelle stoppen normalerweise, wenn sie ihre Verarbeitung auf natürliche Weise beendet haben. In diesem Fall ist der Wert des stop_reason-Antwortfeldes end_turn. Wenn Sie möchten, dass das Modell nicht mehr generiert wird, wenn es auf benutzerdefinierte Textzeichenfolgen trifft, können Sie den stop_sequences-Parameter verwenden. Wenn das Modell auf eine der benutzerdefinierten Textzeichenfolgen trifft, lautet der Wert des stop_reason-Antwortfeldes stop_sequence und der Wert von stop_sequence enthält die übereinstimmende Stoppsequenz.

Die maximale Anzahl von Einträgen ist 8 191.

temperature – (optional) Die Menge an Zufälligkeit, die der Antwort hinzugefügt wurde.

Standard	Minimum	Maximum
1	0	1

top_p – (optional) Verwenden Sie Nukleus-Sampling.

Beim Nukleus-Sampling berechnet Anthropic Claude die kumulative Verteilung über alle Optionen für jedes nachfolgende Token in absteigender Wahrscheinlichkeitsreihenfolge und beendet den Vorgang, sobald eine bestimmte, durch top_p festgelegte Wahrscheinlichkeit erreicht ist. Wenn Sie die Sampling-Parameter anpassen, ändern Sie entweder temperature oder top_p. Ändern Sie nicht beide gleichzeitig.

Standard	Minimum	Maximum
0,999	0	1

top_k – (optional) Nehmen Sie für jedes nachfolgende Token nur Stichproben aus den Top-K-Optionen vor.

Verwenden Sie top_k, um Antworten mit langen Ausläufern und geringer Wahrscheinlichkeit zu entfernen.

Standard	Minimum	Maximum
Standardmäßig deaktiviert	0	500

tools – (optional) Definitionen von Tools, die das Modell verwenden kann.

Anmerkung

Erfordert ein Modell von Anthropic Claude 3.

Wenn Sie tools in Ihrer Anforderung angeben, gibt das Modell möglicherweise tool_use-Inhaltsblöcke zurück, die die Verwendung dieser Tools durch das Modell darstellt. Sie können diese Tools dann mit der vom Modell generierten Tool-Eingabe ausführen und anschließend optional Ergebnisse mithilfe von tool_result-Inhaltsblöcken an das Modell zurückgeben.

Sie können die folgenden Tool-Typen übergeben:

Benutzerdefiniert

Definition für ein benutzerdefiniertes Tool.

(optional) type – Der Typ des Tools. Falls dieser definiert ist, verwenden Sie den Wert custom.
name – Der Name des Tools
Beschreibung – (optional, aber dringend empfohlen) die Beschreibung des Tools
input_schema – Das JSON-Schema für das Tool.

Computer

Definition für das Computer-Tool, das Sie mit der Computer-Use-API verwenden.

type – Der Wert muss computer_20241022 sein.
name – Der Wert muss computer sein.

(Erforderlich) display_height_px – Die Höhe der Anzeige, die vom Modell gesteuert wird, in Pixeln.

Standard	Minimum	Maximum
Keine	1	Kein Maximum

(Erforderlich) display_width_px – Die Breite der Anzeige, die vom Modell gesteuert wird, in Pixeln.

Standard	Minimum	Maximum
Keine	1	Kein Maximum

(Optional) display_number – Die zu steuernde Anzeigenummer (nur relevant für X11-Umgebungen). Falls angegeben, erhält das Tool eine Anzeigenummer in der Tool-Definition.

Standard	Minimum	Maximum
Keine	0	N

bash

Definition für das Bash-Tool, das Sie mit der Computer-Use-API verwenden.

(optional) type – Der Wert muss bash_20241022 sein.
name – Der Wert muss bash sein und dem Tool entsprechen.

Text-Editor

Definition für das Text-Editor-Tool, das Sie mit der Computer-Use-API verwenden.

(optional) type – Der Wert muss text_editor_20241022 sein.
name – Der Wert muss str_replace_editor sein und dem Tool entsprechen.

tool_choice – (optional) Gibt an, wie das Modell die bereitgestellten Tools verwenden soll. Das Modell kann ein bestimmtes Tool bzw. jedes verfügbare Tool verwenden oder selbst entscheiden.

Anmerkung
Erfordert ein Modell von Anthropic Claude 3.
- type – Der Typ der Tool-Auswahl. Mögliche Werte sind any (jedes verfügbare Werkzeug verwenden), auto (das Modell entscheidet) und tool (das angegebene Tool verwenden).
- name – (optional) Der Name des zu verwendenden Tools. Erforderlich, wenn Sie tool im Feld type angeben.

Response

Das Anthropic-Claude-Modell gibt die folgenden Felder für einen Inferenzaufruf für Nachrichten zurück.


{
    "id": string,
    "model": string,
    "type" : "message",
    "role" : "assistant",
    "content": [
        {
            "type": string,
            "text": string,
            "image" :json,
            "id": string,
            "name":string,
            "input": json
        }
    ],
    "stop_reason": string,
    "stop_sequence": string,
    "usage": {
        "input_tokens": integer,
        "output_tokens": integer
    }
    
}

Beispielantworten mit neuen stop_reason-Werten:


// Example with refusal
{
    "stop_reason": "refusal",
    "content": [
        {
            "type": "text",
            "text": "I can't help with that request."
        }
    ]
}

// Example with tool_use
{
    "stop_reason": "tool_use",
    "content": [
        {
            "type": "tool_use",
            "id": "toolu_123",
            "name": "calculator",
            "input": {"expression": "2+2"}
        }
    ]
}

// Example with model_context_window_exceeded (Claude Sonnet 4.5)
{
    "stop_reason": "model_context_window_exceeded",
    "content": [
        {
            "type": "text",
            "text": "The response was truncated due to context window limits..."
        }
    ]
}

ID – Die eindeutige Kennung für die Antwort. Das Format und die Länge der ID können sich im Laufe der Zeit ändern.
model – Die ID für das Anthropic-Claude-Modell, das die Anfrage gestellt hat.
stop_reason – Der Grund, warum Anthropic Claude keine Antwort mehr generiert hat.
- end_turn – Das Modell hat einen natürlichen Haltepunkt erreicht.
- max_tokens – Der generierte Text hat den Wert des max_tokens-Eingabefeldes oder die maximale Anzahl von Token überschritten, die das Modell unterstützt.
- stop_sequence – Das Modell hat eine der Stoppsequenzen generiert, die Sie im stop_sequences-Eingabefeld angegeben haben.
- Ablehnung – Claude weigert sich aus Sicherheitsgründen, eine Antwort zu generieren.
- tool_use – Claude ruft ein Tool auf und erwartet, dass Sie es ausführen.
- model_context_window_exceeded – Das Modell hat die Generierung gestoppt, weil das Kontextfensterlimit erreicht wurde.
  - Neu mit Claude Sonnet 4.5
stop_sequence – Die Stoppsequenz, mit der die Generierung beendet wurde.
type – Die Art der Antwort Dieser Wert ist immer message.
role – Die Konversationsrolle der generierten Nachricht Dieser Wert ist immer assistant.
Inhalt – Der vom Modell generierte Inhalt. Als Array zurückgegeben. Es gibt drei Inhaltstypen: text, tool_use und image.
- text – Eine Textantwort
  - type – Die Art des Inhalts Dieser Wert ist text.
  - text – Wenn der Wert des Felds type „text“ ist, enthält es den Text des Inhalts.
- tool use – Eine Anfrage des Modells zur Verwendung eines Tools
  - type – Die Art des Inhalts Dieser Wert ist tool_use.
  - id – Die ID des Tools, dessen Verwendung das Modell anfordert
  - name – Enthält den Namen des angeforderten Tools
  - input – Die Eingabeparameter, die an das Tool übergeben werden sollen
- Image – Eine Anfrage des Modells zur Verwendung eines Tools
  - type – Die Art des Inhalts Dieser Wert ist image.
  - source – Enthält das Bild Weitere Informationen finden Sie unter Multimodale Prompts.
usage – Container für die Anzahl der Token, die Sie in der Anfrage angegeben haben, und für die Anzahl der Token, die das Modell in der Antwort generiert hat
- input_tokens – Die Anzahl der Eingabe-Token in der Anfrage
- output_tokens – Die Anzahl der Token, die das Modell in der Antwort generiert hat
- stop_sequence – Das Modell hat eine der Stoppsequenzen generiert, die Sie im stop_sequences-Eingabefeld angegeben haben.

Aufwandsparameter (Beta)

Der effort Parameter ist eine Alternative zu denkenden Token-Budgets für Claude Opus 4.5. Dieser Parameter gibt an, Claude wie großzügig es Tokens ausgeben sollte, um das beste Ergebnis zu erzielen, und passt die Token-Nutzung je nach Denkweise, Toolaufrufen und Benutzerkommunikation an. Er kann mit oder ohne erweiterten Denkmodus verwendet werden.

Der Aufwandsparameter kann wie folgt eingestellt werden:

high(Standard) — Claude gibt so viele Token aus, wie für das beste Ergebnis erforderlich sind
medium— Ausgewogene Token-Nutzung
low— Konservative Token-Verwendung

Um diese Funktion nutzen zu können, müssen Sie den Beta-Header übergebeneffort-2025-11-24.

Anfragebeispiel:


{
    "anthropic_version": "bedrock-2023-05-31",
    "anthropic_beta": [
        "effort-2025-11-24"
    ],
    "max_tokens": 4096,
    "output_config": {
        "effort": "medium"
    },
    "messages": [{
        "role": "user",
        "content": "Analyze this complex dataset and provide insights"
    }]
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Unterschiede im Denken zwischen den Modellversionen

Codebeispiele