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 reference/messages_posthttps://docs.anthropic.com/claude/.

Warnung

Claude Sonnet 4.5und unterstützt Claude Haiku 4.5 nur die Angabe eines temperature oder top_p -Parameters, kann aber nicht beide verarbeiten. Dies gilt nicht für ältere Modelle.

Request

AnthropicClaudehat die folgenden Inferenzparameter für einen Nachrichten-Inferenzaufruf.


{
    "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 die Generierung von Token möglicherweise beenden, bevor sie den Wert von erreichen. max_tokens Verschiedene Anthropic Claude Modelle haben unterschiedliche Maximalwerte für diesen Parameter. Weitere Informationen finden Sie unter Modellvergleich.

messages — (Erforderlich) Die Eingabemeldungen.

Rolle — Die Rolle der Konversation. Gültige Werte sind user und assistant.

Minimum	Maximum
0	2000

content — (erforderlich) Der Inhalt der Konversation als eine Reihe von Objekten. Jedes Objekt enthält ein Typfeld, in dem Sie einen der folgenden Werte angeben können:
- text— Wenn Sie diesen Typ angeben, müssen Sie ein Textfeld einschließen und die Texteingabeaufforderung als Wert angeben. Wenn es sich bei einem anderen Objekt in der Reihe um ein Bild handelt, gilt diese Texteingabe für die Bilder.
- image— Wenn Sie diesen Typ angeben, müssen Sie ein Quellfeld angeben, das einem Objekt mit den folgenden Feldern zugeordnet ist:
  - type — (erforderlich) Der Kodierungstyp für das Bild. Sie können angebenbase64.
  - 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 Bildgröße beträgt 3,75 MB. Die maximale Höhe und Breite eines Bildes beträgt 8000 Pixel.

Die folgenden Parameter sind optional.

system — (Optional) Die Systemaufforderung für die Anforderung.

Eine Systemaufforderung ist eine Möglichkeit, Kontext und Anweisungen bereitzustellen AnthropicClaude, z. B. die Angabe eines bestimmten Ziels oder einer bestimmten Rolle. Weitere Informationen finden Sie in der Anthropic Dokumentation unter Systemaufforderungen.

Anmerkung
Sie können Systemaufforderungen mit Anthropic Claude Version 2.1 oder höher verwenden.

anthropic_beta — (Optional) Der anthropische Beta-Parameter ist eine Liste von Zeichenketten von Beta-Headern, die verwendet werden, um anzugeben, dass Sie sich für einen bestimmten Satz von Beta-Funktionen angemeldet haben.

Anmerkung

Die Variante von 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 Servicebedingungen definiert. AWS 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 Preisseite von Amazon Bedrock. Es gelten separate Service Quotas (weitere Informationen finden Sie unter Servicekontingenten im AWS Management Console).

Zu den verfügbaren Beta-Headern gehören die folgenden:

Beta-Funktion	Beta-Header	Hinweise
Nutzung des Computers	`computer-use-2025-01-24`	Kompatibel mitClaude 3.7 Sonnet.
Verwendung des Werkzeugs	`token-efficient-tools-2025-02-19`	Kompatibel mit Claude 3.7 Sonnet und Claude 4+.
Verschachteltes Denken	`Interleaved-thinking-2025-05-14`	Kompatibel mit mehr als Claude 4 Modellen.
Ermöglicht Ausgabetokens von bis zu 128 KB	`output-128k-2025-02-19`	Kompatibel mitClaude 3.7 Sonnet.
Entwicklermodus für rohes Denken an Claude mehr als 4 Modellen	`dev-full-thinking-2025-05-14`	Nur mit Claude mehr als 4 Modellen kompatibel. Wenden Sie sich an Ihr Account-Team, um auf diese Betaversion zuzugreifen.
1 Million Tokens	`context-1m-2025-08-07`	Kompatibel mit Claude Sonnet 4
Kontext-Management	`context-management-2025-06-27`	Kompatibel mit Claude Sonnet 4.5 und Claude Haiku 4.5

stop_sequences — (Optional) Benutzerdefinierte Textsequenzen, die dazu führen, dass das Modell nicht mehr generiert wird. AnthropicClaudeModelle stoppen normalerweise, wenn sie ihren Zug 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 Textfolgen 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 beträgt 8191.

Temperatur — (optional) Die Menge an Zufälligkeit, die in die Antwortvariable injiziert wurde.

Standard	Minimum	Maximum
1	0	1

top_p — (Optional) Verwenden Sie die Nukleus-Sampling.

AnthropicClaudeBerechnet bei der Nukleusabtastung die kumulative Verteilung über alle Optionen für jedes nachfolgende Token in absteigender Wahrscheinlichkeitsreihenfolge und schneidet sie ab, sobald sie eine bestimmte Wahrscheinlichkeit erreicht, die durch angegeben ist. top_p Wenn Sie die Stichprobenparameter anpassen, ändern Sie entweder odertemperature. top_p Ändern Sie nicht beide gleichzeitig.

Standard	Minimum	Maximum
0,999	0	1

top_k — (Optional) Nur Stichproben aus den Top K-Optionen für jedes nachfolgende Token.

Wird verwendettop_k, um Long-Tail-Antworten mit niedriger Wahrscheinlichkeit zu entfernen.

Standard	Minimum	Maximum
Standardmäßig deaktiviert	0	500

tools — (Optional) Definitionen von Tools, die das Modell verwenden kann.

Anmerkung

Erfordert ein Anthropic Claude 3-Modell.

Wenn Sie dies tools in Ihrer Anfrage angeben, gibt das Modell möglicherweise tool_use Inhaltsblöcke zurück, die die Verwendung dieser Tools durch das Modell darstellen. Sie können diese Werkzeuge dann mit der vom Modell generierten Werkzeugeingabe ausführen und dann optional die Ergebnisse mithilfe von tool_result Inhaltsblöcken an das Modell zurückgeben.

Sie können die folgenden Werkzeugtypen übergeben:

Custom (Benutzerdefiniert)

Definition für ein benutzerdefiniertes Tool.

(optional) Typ — Der Typ des Werkzeugs. Falls definiert, verwenden Sie den Wertcustom.
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 Computertool, das Sie mit der Computer-Use-API verwenden.

type — Der Wert muss seincomputer_20241022.
name — Der Wert muss seincomputer.

(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 Display-Nummer (nur relevant für X11-Umgebungen). Falls angegeben, erhält das Werkzeug eine Anzeigenummer in der Werkzeugdefinition.

Standard	Minimum	Maximum
Keine	0	N

bash

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

(optional) Typ — Der Wert muss sein. bash_20241022
name — Der Wert muss... bash das Tool sein.

Texteditor

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

(optional) Typ — Der Wert muss seintext_editor_20241022.
name — Der Wert muss... str_replace_editor das Tool sein.

tool_choice — (Optional) Gibt an, wie das Modell die bereitgestellten Tools verwenden soll. Das Modell kann ein bestimmtes Werkzeug oder jedes verfügbare Werkzeug verwenden oder selbst entscheiden.

Anmerkung
Erfordert ein Anthropic Claude 3-Modell.
- Typ — Der Typ der Werkzeugauswahl. Mögliche Werte sind any (jedes verfügbare Werkzeug verwenden), auto (das Modell entscheidet) und tool (das angegebene Werkzeug verwenden).
- name — (Optional) Der Name des zu verwendenden Tools. Erforderlich, wenn Sie dies tool in dem type Feld angeben.

Response

Das Anthropic Claude Modell gibt die folgenden Felder für einen Nachrichten-Inferenzaufruf 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 die Generierung der Anthropic Claude Antwort beendet wurde.
- 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 Eingabefeld angegeben haben. stop_sequences
- 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 Kontext-Fensterlimit 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.
Rolle — 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.
  - Typ — Der Typ des Inhalts. Dieser Wert ist text.
  - text — Wenn der Wert von Text type ist, enthält er den Text des Inhalts.
- Werkzeugverwendung — Eine Anfrage des Modells zur Verwendung eines Werkzeugs.
  - type — Der Typ 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.
- Bild — Eine Anfrage des Modells zur Verwendung eines Tools.
  - Typ — Der Typ des Inhalts. Dieser Wert ist image.
  - Quelle — Enthält das Bild. Weitere Informationen finden Sie unter Multimodale Eingabeaufforderungen.
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 Tokens, die das Modell in der Antwort generiert hat.
- stop_sequence — Das Modell hat eine der Stoppsequenzen generiert, die Sie im Eingabefeld angegeben haben. stop_sequences

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