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





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

## Modelleinstellungen [#modelleinstellungen]

| Einstellung                              | Claude Opus 5.5                       |
| ---------------------------------------- | ------------------------------------- |
| Modell-ID                                | `claude-opus-5-5`                     |
| Kontextfenster                           | 1M Tokens                             |
| Maximale synchrone Ausgabe               | 128000 Tokens einschließlich Thinking |
| Thinking-Modi                            | Adaptiv, immer aktiv                  |
| Standardwert für effort                  | `medium`                              |
| 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-opus-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-opus-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]

| Name                                                                                                      | Typ                   | Erforderlich | Standard               | Hinweise                                                                                                                                                                                                                                                                    |
| --------------------------------------------------------------------------------------------------------- | --------------------- | ------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`                                                                                                   | string                | Ja           | —                      | `claude-opus-5-5`.                                                                                                                                                                                                                                                          |
| `max_tokens`                                                                                              | integer               | Ja           | —                      | 0–128000. Schließt die für Thinking verwendeten Tokens ein. `0` befüllt nur den Prompt-Cache vorab.                                                                                                                                                                         |
| `messages`                                                                                                | object\[]             | Ja           | —                      | Abwechselnde `user`- und `assistant`-Beiträge; `content` ist eine Zeichenfolge oder ein Array von Inhaltsblöcken. Der letzte Beitrag muss `user` sein. Ausnahme: Zum Fortsetzen einer `pause_turn`-Antwort sendest du deren Inhalt als letzte `assistant`-Nachricht zurück. |
| `system`                                                                                                  | string oder object\[] | Nein         | —                      | System-Prompt.                                                                                                                                                                                                                                                              |
| `thinking`                                                                                                | object                | Nein         | `{"type": "adaptive"}` | Thinking ist adaptiv und immer aktiv. `display`: `omitted` (Standard) oder `summarized`.                                                                                                                                                                                    |
| `output_config.effort`                                                                                    | enum                  | Nein         | `medium`               | `low`, `medium`, `high`, `xhigh`, `max`. Steuert, wie viel das Modell nachdenkt.                                                                                                                                                                                            |
| `output_config.format`                                                                                    | object                | Nein         | —                      | Ein JSON-Schema für strukturierte Ausgabe.                                                                                                                                                                                                                                  |
| `stop_sequences`                                                                                          | string\[]             | Nein         | —                      | Stoppt, sobald eine dieser Zeichenfolgen erzeugt wird.                                                                                                                                                                                                                      |
| `stream`                                                                                                  | boolean               | Nein         | `false`                | Überträgt die Antwort als Server-Sent Events.                                                                                                                                                                                                                               |
| `temperature`                                                                                             | number                | Nein         | —                      | Nur `1` (der Standardwert) wird aus Gründen der Abwärtskompatibilität akzeptiert; jeder andere Wert führt zu einem 400-Fehler. Weglassen.                                                                                                                                   |
| `top_p`                                                                                                   | number                | Nein         | —                      | Nur Werte von `0.99` bis `1` werden aus Gründen der Abwärtskompatibilität akzeptiert; jeder andere Wert führt zu einem 400-Fehler. Weglassen.                                                                                                                               |
| `top_k`                                                                                                   | integer               | Nein         | —                      | Nicht zulässig: Jeder Wert führt zu einem 400-Fehler. Weglassen.                                                                                                                                                                                                            |
| `tools`                                                                                                   | object\[]             | Nein         | —                      | Tool-Definitionen.                                                                                                                                                                                                                                                          |
| `tool_choice`                                                                                             | object                | Nein         | —                      | `auto` oder `none`; das Erzwingen eines Tools (`any` oder `tool`) wird von diesem Modell nicht unterstützt.                                                                                                                                                                 |
| `metadata.user_id`                                                                                        | string                | Nein         | —                      | Eine nicht sprechende Kennung für deinen Endnutzer mit bis zu 512 Zeichen.                                                                                                                                                                                                  |
| `cache_control`                                                                                           | object                | Nein         | —                      | Prompt-Cache-Breakpoint auf oberster Ebene.                                                                                                                                                                                                                                 |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —                     | Nein         | —                      | Native optionale Felder; siehe „Aktuell unterstützte API-Funktionen“ für Felder, die diese Anbindung filtert.                                                                                                                                                               |

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

Claude Opus 5.5 nutzt immer adaptives Thinking: Das Modell bestimmt selbst, wie viel es nachdenkt, und `output_config.effort` steuert diesen Aufwand. Ein höherer Aufwand bedeutet normalerweise mehr Ausgabe-Tokens, eine längere Wartezeit und höhere Kosten. Mit `thinking.display` auf `summarized` enthält die Antwort `thinking`-Blöcke, die du anzeigen kannst; bei `omitted` werden sie ausgelassen. Thinking-Tokens werden als Ausgabe-Tokens berechnet.

## 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 Opus 5.5

`claude-opus-5-5`

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

— 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-opus-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-opus-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-opus-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.
