Claude Messages | API-Dokumentation

# Claude Messages

Native Claude Messages-compatible API. This endpoint uses Anthropic Messages request and response shapes, including tool calls and Anthropic SSE events.

POST https://api.apihop.ai/anthropic/v1/messages

Native Claude Messages-compatible API. This endpoint uses Anthropic Messages request and response shapes, including tool calls and Anthropic SSE events.

Claude Sonnet 4.6 (`claude-sonnet-4-6`) is supported by the upstream supplier but is not currently published on RequestBeam. It is not an active integration default. Before calling any model, confirm access with your own `GET https://api.apihop.ai/v1/models` response.

```text
POST https://api.apihop.ai/anthropic/v1/messages
```

## Authentication

All requests require a RequestBeam API Key. Anthropic SDKs, Claude Code, and compatible clients usually use `x-api-key`; plain HTTP clients may also use Bearer Token authentication.

```http
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
```

```http
Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
```

## Body

### `model` (string, required, Default: claude-sonnet-5-5)

Supported Claude model IDs.

- `claude-fable-5`
- `claude-fable-5-1`
- `claude-opus-4-6`
- `claude-opus-4-7`
- `claude-opus-4-8`
- `claude-opus-5`
- `claude-opus-5-5`
- `claude-sonnet-5`
- `claude-sonnet-5-5`

Use `GET https://api.apihop.ai/v1/models` for the models currently available to your API Key.

### `max_tokens` (integer, required)

Maximum number of output tokens, as a positive safe integer. This budget includes both thinking and final text output tokens. Missing, zero, negative, fractional, string, or unsafe-integer values return HTTP `400` with `invalid_request_error` before generation or billing. The model may impose a lower maximum.

For models that produce thinking, a small budget such as `128` may yield only thinking blocks before ending with `stop_reason: "max_tokens"`, without text output. Set an explicit budget for the task and the selected model, allowing room for thinking and the final answer. The values in the examples are editable allowances, not upstream defaults or model limits; larger allowances may increase output usage and cost.

### `messages` (object[], required)

Conversation messages. Each message contains `role` and `content`.

`role` supports `user` and `assistant`. `content` may be a string or an array of content blocks.

### `system` (string | object[])

System prompt. Anthropic Messages uses a top-level `system` field instead of a `system` role in `messages`.

### `stream` (boolean, Default: false)

Whether to return Anthropic SSE events.

### `temperature` (number)

Sampling temperature. Accepted values and effects vary by the selected model.

### `top_p` (number)

Nucleus sampling parameter. Acceptance does not guarantee that it changes generation behavior.

### `top_k` (integer)

Top-k sampling parameter. Support depends on the selected model.

### `stop_sequences` (string[])

Stop sequences.

Requests with nonempty stop sequences avoid model services known not to support them; if no compatible service is available, the request returns `400` before generation or billing.

### `tools` (object[])

Anthropic tool definitions. Function tools usually include `name`, `description`, and `input_schema`.

### `tool_choice` (object)

Tool selection policy, such as `{ "type": "auto" }` or `{ "type": "tool", "name": "..." }`.

### `thinking` (object)

Native Anthropic thinking configuration, subject to the selected model and provider's support. Claude 4.5 uses `{ "type": "enabled", "budget_tokens": 1024 }`; Claude Sonnet/Opus 4.6 also support adaptive thinking. Do not apply a manual budget to every model version. In tool continuations, return the complete ordered assistant content, including `thinking`, `signature`, `redacted_thinking` and `tool_use`, unchanged. Keep the thinking configuration and required `anthropic-beta` headers consistent through the tool round trip. For SSE, concatenate `signature_delta.signature` fragments for the same content block; an empty thinking summary does not mean its signature can be discarded. A provider account access rejection is an upstream failure, not evidence of an invalid signature. Recognized Bedrock account access rejections return HTTP 502 with `api_error`; ordinary client validation errors retain HTTP 400. Acceptance still requires an enabled upstream account.

### `metadata` (object)

Request metadata.

### Prompt Caching

Add `cache_control: { "type": "ephemeral" }` to a `system` or message content block. Cache usage may include `cache_creation_input_tokens`, `cache_read_input_tokens`, and supported 5-minute or 1-hour creation buckets. A 1-hour TTL also requires the corresponding `anthropic-beta` header.

## Request Examples

### Non-Streaming

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce yourself in one sentence."
    }
  ],
  "stream": false
}
```

### Streaming

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Reply exactly OK."
    }
  ],
  "stream": true
}
```

## Response

Non-streaming responses keep the Anthropic Message shape.

### `id` (string)

Response ID, such as `msg_...`.

### `type` (string)

Object type, usually `message`.

### `role` (string)

Usually `assistant`.

### `model` (string)

Actual Claude model used.

### `content` (object[])

Native output content blocks, including `text`, `tool_use`, and `thinking` when used.

### `stop_reason` (string)

Stop reason, such as `end_turn`, `max_tokens`, `stop_sequence`, or `tool_use`.

### `usage` (object)

Token usage, including `input_tokens` and `output_tokens`. Cache token fields are included when present.

### Success Example

```json
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Hello, I am Claude and can help with writing, coding, and analysis tasks."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 24
  }
}
```

## Streaming Response

When `stream: true`, the endpoint returns Anthropic SSE events. Common events include:

- `message_start`
- `content_block_start`
- `content_block_delta`
- `content_block_stop`
- `ping`
- `message_delta`
- `message_stop`

## Error Response

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for the full code reference, protocol differences, and diagnostic steps.

Error responses use the Anthropic-style shape:

```json
{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid credentials or API key has expired."
  }
}
```

Native Claude-Messages-kompatible API. Dieser Endpunkt verwendet Anfrage- und Antwortstrukturen von Anthropic Messages, einschließlich Werkzeugaufrufen und Anthropic-SSE-Ereignissen.

Claude Sonnet 4.6 (claude-sonnet-4-6) wird vom vorgelagerten Anbieter unterstützt, ist aber derzeit nicht bei RequestBeam veröffentlicht. Es ist kein aktiver Integrationsstandard. Bestätigen Sie vor jedem Modellaufruf den Zugriff anhand Ihrer eigenen Antwort von GET https://api.apihop.ai/v1/models.

text

POST https://api.apihop.ai/anthropic/v1/messages

Authentifizierung

Alle Anfragen erfordern einen RequestBeam-API-Schlüssel. Anthropic-SDKs, Claude Code und kompatible Clients verwenden üblicherweise x-api-key; einfache HTTP-Clients können auch Bearer-Token-Authentifizierung verwenden.

http

x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

http

Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

Anfragekörper

modelstringerforderlichStandard: claude-sonnet-5-5

Unterstützte Claude-Modell-IDs.

claude-fable-5
claude-fable-5-1
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-opus-5-5
claude-sonnet-5
claude-sonnet-5-5

Verwenden Sie GET https://api.apihop.ai/v1/models, um die aktuell für Ihren API-Schlüssel verfügbaren Modelle zu sehen.

max_tokensintegererforderlich

Maximale Anzahl der Ausgabetokens als positive sichere Ganzzahl. Dieses Budget umfasst Denk- und endgültige Textausgabetokens. Fehlende, nullwertige, negative, gebrochene, als Zeichenfolge übergebene oder unsichere Ganzzahlwerte liefern vor Generierung oder Abrechnung HTTP 400 mit invalid_request_error. Das Modell kann eine niedrigere Obergrenze festlegen.

Bei Modellen mit Denkprozess kann ein kleines Budget wie 128 nur Denkblöcke erzeugen und danach mit stop_reason: "max_tokens" ohne Textausgabe enden. Legen Sie passend zu Aufgabe und Modell ein ausdrückliches Budget mit Platz für Denkprozess und endgültige Antwort fest. Die Beispielwerte sind anpassbare Budgets, keine Anbieterstandardwerte oder Modellgrenzen; größere Budgets können Ausgabenutzung und Kosten erhöhen.

messagesobject[]erforderlich

Nachrichten der Unterhaltung. Jede Nachricht enthält role und content.

role unterstützt user und assistant. content kann eine Zeichenfolge oder ein Array von Inhaltsblöcken sein.

systemstring | object[]

Systemprompt. Anthropic Messages verwendet ein oberstes Feld system statt einer Rolle system in messages.

streambooleanStandard: false

Ob Anthropic-SSE-Ereignisse zurückgegeben werden.

temperaturenumber

Sampling-Temperatur. Akzeptierte Werte und Auswirkungen hängen vom gewählten Modell ab.

top_pnumber

Nucleus-Sampling-Parameter. Die Annahme garantiert keine Änderung des Generierungsverhaltens.

top_kinteger

Top-k-Sampling-Parameter. Die Unterstützung hängt vom gewählten Modell ab.

stop_sequencesstring[]

Stoppsequenzen.

Anfragen mit nicht leeren Stoppsequenzen umgehen Modelldienste, die diese bekanntermaßen nicht unterstützen. Ist kein kompatibler Dienst verfügbar, liefert die Anfrage vor Generierung oder Abrechnung 400.

toolsobject[]

Anthropic-Werkzeugdefinitionen. Funktionswerkzeuge enthalten gewöhnlich name, description und input_schema.

tool_choiceobject

Werkzeugauswahlregel, etwa { "type": "auto" } oder { "type": "tool", "name": "..." }.

thinkingobject

Native Anthropic-Denkkonfiguration, abhängig von Modell- und Anbieterunterstützung. Claude 4.5 verwendet { "type": "enabled", "budget_tokens": 1024 }; Claude Sonnet/Opus 4.6 unterstützen auch adaptives Denken. Wenden Sie nicht auf jede Modellversion ein manuelles Budget an. Geben Sie bei Werkzeugfortsetzungen den vollständigen geordneten Assistenteninhalt einschließlich thinking, signature, redacted_thinking und tool_use unverändert zurück. Behalten Sie die Denkkonfiguration und erforderlichen anthropic-beta-Header während des Werkzeug-Rundlaufs bei. Verketten Sie bei SSE die Fragmente von signature_delta.signature desselben Inhaltsblocks; eine leere Denkzusammenfassung erlaubt nicht das Verwerfen der Signatur. Eine Ablehnung des Zugriffs auf ein Anbieterkonto ist ein Anbieterfehler, kein Beleg für eine ungültige Signatur. Erkannte Bedrock-Kontozugriffsablehnungen liefern HTTP 502 mit api_error; normale Client-Validierungsfehler bleiben HTTP 400. Die Annahme erfordert weiterhin ein aktiviertes Anbieterkonto.

metadataobject

Anfragemetadaten.

Prompt-Zwischenspeicherung

Fügen Sie cache_control: { "type": "ephemeral" } einem system- oder Nachrichteninhaltsblock hinzu. Die Cachenutzung kann cache_creation_input_tokens, cache_read_input_tokens und unterstützte Erstellungsgruppen für 5 Minuten oder 1 Stunde enthalten. Eine TTL von 1 Stunde erfordert außerdem den entsprechenden anthropic-beta-Header.

Anfragebeispiele

Ohne Streaming

json

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, introduce yourself in one sentence."
    }
  ],
  "stream": false
}

Mit Streaming

json

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Reply exactly OK."
    }
  ],
  "stream": true
}

Antwort

Antworten ohne Streaming behalten die Anthropic-Message-Struktur bei.

idstring

Antwort-ID, etwa msg_....

typestring

Objekttyp, gewöhnlich message.

rolestring

Gewöhnlich assistant.

modelstring

Tatsächlich verwendetes Claude-Modell.

contentobject[]

Native Ausgabeinhaltsblöcke, einschließlich text, tool_use und gegebenenfalls thinking.

stop_reasonstring

Stoppgrund, etwa end_turn, max_tokens, stop_sequence oder tool_use.

usageobject

Tokennutzung, einschließlich input_tokens und output_tokens. Cache-Tokenfelder werden eingeschlossen, wenn vorhanden.

Erfolgsbeispiel

json

{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Hello, I am Claude and can help with writing, coding, and analysis tasks."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "output_tokens": 24
  }
}

Streaming-Antwort

Bei stream: true liefert der Endpunkt Anthropic-SSE-Ereignisse. Häufige Ereignisse sind:

message_start
content_block_start
content_block_delta
content_block_stop
ping
message_delta
message_stop

Fehlerantwort

Die vollständige Codereferenz, Protokollunterschiede und Diagnoseschritte finden Sie unter Fehlercodes und Fehlerbehebung.

Fehlerantworten verwenden die Struktur im Anthropic-Stil:

json

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid credentials or API key has expired."
  }
}