# Claude Sonnet 5.5 API (https://wanapi.app/de/docs/claude-sonnet-5-5)





Diese Referenz beschreibt **Claude Sonnet 5.5** und die modellspezifischen Messages-Parameter. Verwende `claude-sonnet-5-5` mit `POST https://api.wanapi.app/v1/messages`. [Claude-Modelle vergleichen](/de/docs/claude-api).

## Modelleinstellungen [#modelleinstellungen]

| Einstellung                              | Claude Sonnet 5.5                     |
| ---------------------------------------- | ------------------------------------- |
| Modell-ID                                | `claude-sonnet-5-5`                   |
| Kontextfenster                           | 1M Tokens                             |
| Maximale synchrone Ausgabe               | 128000 Tokens einschließlich Thinking |
| Thinking-Modi                            | Adaptiv oder between\_tools           |
| Standardwert für effort                  | `high`                                |
| Erzwungene Tool-Aufrufe (`any` / `tool`) | Nicht unterstützt                     |

## Verbindung einrichten und Anfrage senden [#verbindung-einrichten-und-anfrage-senden]

Erstelle in den [Einstellungen für API-Schlüssel](/de/settings/apikeys) einen Schlüssel. Ein API-Schlüssel funktioniert für alle Modelle und Gruppen. Speichere ihn in deiner Serverumgebung als `WAN_API_KEY`. Sende `anthropic-version: 2023-06-01`; ergänze `anthropic-beta` nur für Funktionen, die diesen Header erfordern.

```bash
curl https://api.wanapi.app/v1/messages \
  -H "x-api-key: $WAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
```

```python
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app",
)
message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))
```

## Aktuell unterstützte API-Funktionen [#aktuell-unterstützte-api-funktionen]

Die folgende Tabelle beschreibt die native Schnittstelle dieses Modells. Wan API leitet Anfragen derzeit über eine Kompatibilitätsschicht weiter. &#x2A;*Verwende einen positiven Wert für `max_tokens`**: Das Gateway ersetzt `0` derzeit durch ein Generierungsbudget. Dieser Wert lässt sich hier daher nicht zum ausschließlichen Vorbefüllen des Caches nutzen.

Das aktuelle Gateway leitet `diagnostics`, `compaction`, `fallbacks`, `fallback_credit_token` und `thread` nicht weiter. Die aktuelle Kanalkonfiguration filtert außerdem `speed`, `service_tier` und `inference_geo`. Diese Felder sind unten zur Erläuterung der Modellschnittstelle dokumentiert, stehen über diese Anbindung aber noch nicht zur Verfügung. Eine erfolgreiche Antwort bedeutet nicht, dass ein ignoriertes Feld wirksam war. Für Beta-Funktionen, die diese Felder benötigen, gilt dieselbe Einschränkung.

## Parameter [#parameter]

| Parameter                         | Typ / erforderlich                      | Offizielle Einschränkungen und Standardwerte                                                                                                                                                                                                                                                                                        |
| --------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                           | string, erforderlich                    | `claude-sonnet-5-5`.                                                                                                                                                                                                                                                                                                                |
| `max_tokens`                      | integer, erforderlich                   | 0–128000 einschließlich Thinking-Tokens. Laut offizieller Schnittstelle befüllt 0 den Prompt-Cache, ohne Ausgabe zu erzeugen; siehe „Aktuell unterstützte API-Funktionen“.                                                                                                                                                          |
| `messages`                        | Objektarray, erforderlich               | Mindestens eine Gesprächsnachricht, höchstens 100000. Jede enthält `role` und `content`; der Inhalt ist eine Zeichenfolge oder ein Array von Inhaltsblöcken. Normale Beiträge verwenden `user`/`assistant`. Für `system`-Nachrichten innerhalb eines Gesprächs gelten die offiziellen Platzierungsregeln.                           |
| `system`                          | Zeichenfolge oder Array von Textblöcken | Anweisungen auf oberster Ebene. Textblöcke können Cache-Breakpoints enthalten.                                                                                                                                                                                                                                                      |
| `thinking`                        | object                                  | Standard: `{"type":"adaptive"}`. Der andere unterstützte Modus ist `{"type":"between_tools"}`. Manuelle Budgets und `disabled` werden abgelehnt.                                                                                                                                                                                    |
| `thinking.display`                | enum                                    | Nur im adaptiven Modus: `omitted` (Standard) oder `summarized`. Eine ausgelassene Zusammenfassung bedeutet nicht, dass Thinking deaktiviert ist.                                                                                                                                                                                    |
| `thinking.block_binding`          | object, Beta                            | Nur im adaptiven Modus. Erfordert `thinking-binding-controls-2026-08-01`; beachte die offiziellen Vorgaben zum Beibehalten von Thinking.                                                                                                                                                                                            |
| `output_config.effort`            | enum oder null                          | `low`, `medium`, `high`, `xhigh`, `max`; Standard `high`. Null belässt den Standardwert.                                                                                                                                                                                                                                            |
| `output_config.format`            | object oder null                        | Strukturierte JSON-Ausgabe: `{"type":"json_schema","schema":{...}}`. Verwende die unterstützte Teilmenge von JSON Schema.                                                                                                                                                                                                           |
| `stream`                          | boolean                                 | Standard `false`; `true` gibt SSE-Ereignisse zurück.                                                                                                                                                                                                                                                                                |
| `stop_sequences`                  | Zeichenfolgenarray                      | Stoppt laut offizieller Schnittstelle die Generierung bei einer passenden Zeichenfolge. Die Kompatibilitätsprüfung beim vorgelagerten Dienst setzte dieses Verhalten nicht durch.                                                                                                                                                   |
| `temperature`                     | number oder null                        | Aus Kompatibilitätsgründen wird nur 1 akzeptiert; weglassen. Andere Werte außer null werden abgelehnt.                                                                                                                                                                                                                              |
| `top_p`                           | number oder null                        | Aus Kompatibilitätsgründen wird nur 0.99–1 akzeptiert; weglassen.                                                                                                                                                                                                                                                                   |
| `top_k`                           | kein Wert außer null                    | Sampling wird nicht unterstützt; lass diese Eigenschaft weg.                                                                                                                                                                                                                                                                        |
| `tools`                           | Objektarray                             | Client-Tools enthalten `name`, `input_schema` und optionale Beschreibungs- bzw. Striktheitseinstellungen. Server-Tools verwenden ihre versionierten offiziellen Definitionen.                                                                                                                                                       |
| `tool_choice`                     | object                                  | `auto` (Standard) oder `none`. `any` und ein benanntes erzwungenes `tool` werden abgelehnt. `auto` darf `disable_parallel_tool_use` enthalten.                                                                                                                                                                                      |
| `metadata.user_id`                | string oder null                        | Höchstens 512 Zeichen; verwende eine nicht sprechende Kennung.                                                                                                                                                                                                                                                                      |
| `cache_control`                   | object oder null                        | `type: "ephemeral"`; `ttl: "5m"` (Standard) oder `"1h"`. Sonnet 5.5 benötigt mindestens 512 cachefähige Tokens. Die offizielle API unterstützt auch Cache-Breakpoints auf Blockebene.                                                                                                                                               |
| `diagnostics`                     | object oder null                        | `previous_message_id`: Zeichenfolge mit höchstens 256 Zeichen oder null. Fordert eine Diagnose von Cache-Abweichungen an.                                                                                                                                                                                                           |
| `service_tier`                    | enum                                    | `auto` (Standard) oder `standard_only`.                                                                                                                                                                                                                                                                                             |
| `speed`                           | enum oder null                          | Weglassen oder `standard` / null verwenden. Sonnet 5.5 unterstützt `fast` nicht.                                                                                                                                                                                                                                                    |
| `inference_geo`                   | string oder null                        | Der offizielle Standard stammt aus den Kontoeinstellungen. Eine angenommene Anfrage allein bestätigt nicht die geografische Verarbeitung.                                                                                                                                                                                           |
| `fallbacks`                       | string, Objektarray oder null, Beta     | `"default"` oder bis zu drei Fallback-Einträge. Jeder erfordert `model`; optionale Überschreibungen sind `max_tokens`, `thinking`, `output_config` und `speed`. Siehe die Fallback-Regeln unten.                                                                                                                                    |
| `fallback_credit_token`           | string, object oder null                | Ein Token aus einer vorherigen Ablehnung oder `{"token":"...","mode":"strict"}`. Die Objektform erfordert `fallback-credit-2026-07-01`; mode ist `strict` (Standard) oder `best_effort`. Darf nicht zusammen mit einem von null abweichenden `fallbacks`-Wert verwendet werden.                                                     |
| `container`                       | string, object oder null                | Container-ID oder Container-Konfiguration mit optionalem `id` und `skills` (höchstens 20). Skills verwenden die offiziellen Typ-, Kennungs- und Versionsfelder.                                                                                                                                                                     |
| `context_management`              | object oder null                        | Offizielle Konfiguration für Kontextbearbeitungen einschließlich `edits`; null lässt die Einstellung weg. Die modellspezifische Kompatibilität der Bearbeitungen gilt weiterhin.                                                                                                                                                    |
| `mcp_servers`                     | Objektarray                             | Offizielle MCP-Serverdefinitionen mit der erforderlichen Beta-Version und Serverauthentifizierung. Eine Prüfung mit leerem Array bestätigt keine entfernte MCP-Ausführung.                                                                                                                                                          |
| `compaction`                      | object oder null, Beta                  | `{"type":"summarize"}` mit `compact-2026-09-04`; null lässt die Komprimierung weg. Aktivierte Komprimierung lässt sich nicht mit einem von null abweichenden `context_management`, Stoppsequenzen oder einem Format für strukturierte Ausgabe kombinieren. Das Verhalten signierter Komprimierung bestand den aktuellen Test nicht. |
| `messages[].output_config.effort` | enum, Beta                              | Effort pro Nachricht in einer Systemnachricht; erfordert `mid-conversation-output-config-2026-07-01`. Systemnachrichten, die ausschließlich effort setzen, dürfen überall stehen; für Systemgruppen mit Inhalt gelten die offiziellen Platzierungsregeln. Im Modus `between_tools` darf effort dadurch nicht verändert werden.      |

## Thinking und Tools [#thinking-und-tools]

`between_tools` akzeptiert nur die Eigenschaft `type` sowie effort `low`, `medium` oder `high`. Sende dabei weder `display` noch `budget_tokens` oder `block_binding`. Beispiel:

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}
```

Das Vorbefüllen einer Assistant-Antwort wird nicht unterstützt. Um einen `pause_turn` fortzusetzen, sende den zurückgegebenen Assistant-Inhalt des Server-Tools unverändert erneut. Komprimierung fasst den vorhandenen Verlauf zusammen und ist kein Vorbefüllen einer Assistant-Antwort. Bewahre Thinking-Blöcke und Signaturen exakt auf; verschiebe sie nicht zwischen Modellen und bearbeite den früheren Verlauf nicht, ohne die offiziellen Bindungsregeln zu beachten.

In der nativen Claude API erfordert Computer Use `computer_toolset_20260801`; `computer_20251124` wird abgelehnt. Advisor-Konfigurationen mit `claude-opus-4-8`, `claude-opus-4-7` oder `claude-sonnet-5` werden für dieses ausführende Modell ebenfalls abgelehnt.

## Medieneingaben [#medieneingaben]

Verwende für Bilder und PDFs öffentlich zugängliche HTTP(S)-URLs in den `content`-Blöcken einer Nutzernachricht. Stelle deine Dateien selbst bereit; diese Anbindung bietet weder eine Files API noch Uploads. Beispiel für eine Bildeingabe:

```json
{"role":"user","content":[
  {"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
  {"type":"text","text":"What does this chart show?"}
]}
```

Verwende für eine PDF einen `document`-Block. Lass Tool-Use-IDs, vollständige Thinking-Blöcke und Signaturen beim Fortsetzen eines Gesprächs unverändert. Deine Anwendung führt Client-Tools aus und gibt ihre Ergebnisse zurück; die Deklaration eines Tools führt es noch nicht aus.

## Preise [#preise]

USD pro 1 Million Tokens

Die aktuellen Tarife enthalten den Multiplikator der jeweiligen Gruppe. Preise werden bis zu 2 Minuten zwischengespeichert.

Ein API-Schlüssel funktioniert für alle Modelle und Gruppen. Standard kennzeichnet die erste geeignete Gruppe in der automatischen Routing-Reihenfolge. Es gelten die Tarife der tatsächlich gewählten Gruppe.

### Claude Sonnet 5.5

`claude-sonnet-5-5`

| Abrechenbare Tokens | claude · Standard · Alle Eingabelängen |
| --- | ---: |
| Eingabe (nicht gecacht) | 1 $ |
| Ausgabe | 5 $ |
| Cache-Lesezugriff | 0,05 $ |
| Cache-Schreibvorgang · 5 Minuten | 1,25 $ |
| Cache-Schreibvorgang · 1 Stunde | 2 $ |

— bedeutet, dass kein verifizierter Preis vorliegt; es bedeutet nicht kostenlos.

Cache-Tarife gelten nur, wenn die Antwort den entsprechenden Cache-Verbrauch ausweist. Zähle gecachte Tokens nicht erneut als nicht gecachte Eingabe.

Multipliziere jede abrechenbare Token-Zahl mit dem passenden Tarif und teile die Summe durch 1.000.000. Thinking-Tokens sind in den Ausgabe-Tokens enthalten und werden nicht erneut berechnet. Für Cache-Lesezugriffe sowie Schreibvorgänge mit 5 Minuten oder 1 Stunde Gültigkeit gelten separate Tarife. Wähle bei längenabhängigen Preisen vor der Kostenberechnung die zutreffende Preisstufe aus.

## Antwort und Streaming [#antwort-und-streaming]

Eine abgeschlossene Nachricht enthält `id`, `type`, `role`, `model`, `content`, `stop_reason` und `usage`. Lies die Textblöcke aus `content`; der erste Block kann stattdessen Thinking oder einen Tool-Aufruf enthalten. Die folgende Antwort dient als Beispiel:

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 18}
}
```

Setze für SSE `stream: true` und verwende `curl -N`. Verarbeite `message_start`, `content_block_start`, `content_block_delta`, `content_block_stop`, `message_delta` und `message_stop` sowie `ping` und Streaming-Fehler. Lies die abschließenden Verbrauchsdaten aus, statt jeden Abschnitt als vollständige Antwort zu behandeln.

## OpenAI-kompatible Formate [#openai-kompatible-formate]

Dieselbe Modell-ID funktioniert mit `POST /v1/chat/completions` und `POST /v1/responses`. Verwende `Authorization: Bearer YOUR_API_KEY` und die OpenAI-SDK-Basis-URL `https://api.wanapi.app/v1`. Chat Completions nutzt `messages`, Responses nutzt `input`. Ihre Felder werden in Messages umgewandelt. Verwende daher `/v1/messages` für die oben dokumentierten nativen Parameter.

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

## Nutzungsprotokolle und Fehler [#nutzungsprotokolle-und-fehler]

Die [LLM-Protokolle](/de/usage) zeigen abgeschlossene Aufrufe der letzten 7 Tage mit Modell, Eingabe-Tokens, Ausgabe-Tokens und Kosten. Aktualisiere die Ansicht nach einem Aufruf und filtere nach `claude-sonnet-5-5`. Verwende für Bilder und Videos die [Aufgabenprotokolle](/de/tasks).

Prüfe bei einer fehlgeschlagenen Anfrage den HTTP-Status und das `error`-Objekt. Prüfe den Schlüssel, den [Kontostand](/de/docs/balance), die Modell-ID und die unterstützten Parameterkombinationen. Eine Ablehnung oder ein Stopp am Ausgabelimit ist etwas anderes als ein HTTP-Fehler. Prüfe bei einer unterbrochenen Anfrage oder einem unterbrochenen Stream vor einem erneuten Versuch die Protokolle: Eine neue Anfrage kann weitere Kosten verursachen.

## Modellreferenzen [#modellreferenzen]

* [Offizieller Überblick zu Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
* [Änderungen und Einschränkungen bei Sonnet 5.5](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
* [Messages-Parameterreferenz](https://platform.claude.com/docs/en/api/messages/create)
* [Effort pro Nachricht](https://platform.claude.com/docs/en/build-with-claude/effort)
* [Bedarfsgesteuerte Komprimierung](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand)
* [Ablehnungen und Fallback](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)
* [Fallback-Gutschrift](https://platform.claude.com/docs/en/build-with-claude/fallback-credit)
