LogoWan API – Dokumentation
Startseite
X (Twitter)
Startseite

Erste Schritte

ÜberblickIntegrationsleitfadenGuthaben prüfenAufgabe löschen

Wan-Modelle

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance-Modelle

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Bildmodelle

Seedream 5.0 ProSeedream 5.5 API

Sprachmodelle

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Claude Sonnet 5.5 API

Claude Sonnet 5.5 API: adaptives Thinking oder between_tools, Parametergrenzen, Streaming und aktuelle Token- und Cache-Preise nach Gruppe.

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.

Modelleinstellungen

EinstellungClaude Sonnet 5.5
Modell-IDclaude-sonnet-5-5
Kontextfenster1M Tokens
Maximale synchrone Ausgabe128000 Tokens einschließlich Thinking
Thinking-ModiAdaptiv oder between_tools
Standardwert für efforthigh
Erzwungene Tool-Aufrufe (any / tool)Nicht unterstützt

Verbindung einrichten und Anfrage senden

Erstelle in den Einstellungen für API-Schlüssel 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.

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."}]
  }'
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

Die folgende Tabelle beschreibt die native Schnittstelle dieses Modells. Wan API leitet Anfragen derzeit über eine Kompatibilitätsschicht weiter. 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

ParameterTyp / erforderlichOffizielle Einschränkungen und Standardwerte
modelstring, erforderlichclaude-sonnet-5-5.
max_tokensinteger, erforderlich0–128000 einschließlich Thinking-Tokens. Laut offizieller Schnittstelle befüllt 0 den Prompt-Cache, ohne Ausgabe zu erzeugen; siehe „Aktuell unterstützte API-Funktionen“.
messagesObjektarray, erforderlichMindestens 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.
systemZeichenfolge oder Array von TextblöckenAnweisungen auf oberster Ebene. Textblöcke können Cache-Breakpoints enthalten.
thinkingobjectStandard: {"type":"adaptive"}. Der andere unterstützte Modus ist {"type":"between_tools"}. Manuelle Budgets und disabled werden abgelehnt.
thinking.displayenumNur im adaptiven Modus: omitted (Standard) oder summarized. Eine ausgelassene Zusammenfassung bedeutet nicht, dass Thinking deaktiviert ist.
thinking.block_bindingobject, BetaNur im adaptiven Modus. Erfordert thinking-binding-controls-2026-08-01; beachte die offiziellen Vorgaben zum Beibehalten von Thinking.
output_config.effortenum oder nulllow, medium, high, xhigh, max; Standard high. Null belässt den Standardwert.
output_config.formatobject oder nullStrukturierte JSON-Ausgabe: {"type":"json_schema","schema":{...}}. Verwende die unterstützte Teilmenge von JSON Schema.
streambooleanStandard false; true gibt SSE-Ereignisse zurück.
stop_sequencesZeichenfolgenarrayStoppt laut offizieller Schnittstelle die Generierung bei einer passenden Zeichenfolge. Die Kompatibilitätsprüfung beim vorgelagerten Dienst setzte dieses Verhalten nicht durch.
temperaturenumber oder nullAus Kompatibilitätsgründen wird nur 1 akzeptiert; weglassen. Andere Werte außer null werden abgelehnt.
top_pnumber oder nullAus Kompatibilitätsgründen wird nur 0.99–1 akzeptiert; weglassen.
top_kkein Wert außer nullSampling wird nicht unterstützt; lass diese Eigenschaft weg.
toolsObjektarrayClient-Tools enthalten name, input_schema und optionale Beschreibungs- bzw. Striktheitseinstellungen. Server-Tools verwenden ihre versionierten offiziellen Definitionen.
tool_choiceobjectauto (Standard) oder none. any und ein benanntes erzwungenes tool werden abgelehnt. auto darf disable_parallel_tool_use enthalten.
metadata.user_idstring oder nullHöchstens 512 Zeichen; verwende eine nicht sprechende Kennung.
cache_controlobject oder nulltype: "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.
diagnosticsobject oder nullprevious_message_id: Zeichenfolge mit höchstens 256 Zeichen oder null. Fordert eine Diagnose von Cache-Abweichungen an.
service_tierenumauto (Standard) oder standard_only.
speedenum oder nullWeglassen oder standard / null verwenden. Sonnet 5.5 unterstützt fast nicht.
inference_geostring oder nullDer offizielle Standard stammt aus den Kontoeinstellungen. Eine angenommene Anfrage allein bestätigt nicht die geografische Verarbeitung.
fallbacksstring, 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_tokenstring, object oder nullEin 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.
containerstring, object oder nullContainer-ID oder Container-Konfiguration mit optionalem id und skills (höchstens 20). Skills verwenden die offiziellen Typ-, Kennungs- und Versionsfelder.
context_managementobject oder nullOffizielle Konfiguration für Kontextbearbeitungen einschließlich edits; null lässt die Einstellung weg. Die modellspezifische Kompatibilität der Bearbeitungen gilt weiterhin.
mcp_serversObjektarrayOffizielle MCP-Serverdefinitionen mit der erforderlichen Beta-Version und Serverauthentifizierung. Eine Prüfung mit leerem Array bestätigt keine entfernte MCP-Ausführung.
compactionobject 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.effortenum, BetaEffort 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

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

{
  "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

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:

{"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

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

Claude Sonnet 5.5 — USD pro 1 Million Tokens
Abrechenbare Tokensclaude · Standard
Alle Eingabelängen
Eingabe (nicht gecacht)1 $
Ausgabe5 $
Cache-Lesezugriff0,05 $
Cache-Schreibvorgang · 5 Minuten1,25 $
Cache-Schreibvorgang · 1 Stunde2 $

— 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

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:

{
  "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

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.

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

Die LLM-Protokolle 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.

Prüfe bei einer fehlgeschlagenen Anfrage den HTTP-Status und das error-Objekt. Prüfe den Schlüssel, den Kontostand, 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

  • Offizieller Überblick zu Sonnet 5.5
  • Änderungen und Einschränkungen bei Sonnet 5.5
  • Messages-Parameterreferenz
  • Effort pro Nachricht
  • Bedarfsgesteuerte Komprimierung
  • Ablehnungen und Fallback
  • Fallback-Gutschrift

Claude Haiku 5.5

Claude Haiku 5.5 API: adaptives oder deaktiviertes Thinking, erzwungene Tool-Aufrufe, Parameter, Streaming und aktuelle Token-Preise nach Gruppe.

Claude Opus 5.5

Claude Opus 5.5 API: adaptives Thinking mit effort medium als Standard, Anfrageparameter, Streaming und aktuelle Token-Preise nach Gruppe.

Inhaltsverzeichnis

ModelleinstellungenVerbindung einrichten und Anfrage sendenAktuell unterstützte API-FunktionenParameterThinking und ToolsMedieneingabenPreiseAntwort und StreamingOpenAI-kompatible FormateNutzungsprotokolle und FehlerModellreferenzen