Tutorial

Claude Opus 5.5 API: sofort lauffähige curl- und Python-Schnelleinstiege

Sep 29, 2026

Claude Opus 5.5 ist das neueste Modell von Anthropic für agentisches Programmieren und Langkontext-Reasoning; hiapi hat die Anbindung am selben Tag abgeschlossen, an dem es auf der Plattform verfügbar wurde. Anders als die Bild-, Video- und Audiomodelle von hiapi – diese laufen alle über das asynchrone Muster POST /v1/tasks → Polling – ist Claude Opus 5.5 ein reines Text-Chat-Modell, sodass für den Aufruf lediglich eine synchrone Anfrage an /v1/chat/completions nötig ist. Diese Anleitung enthält einen direkt ausführbaren curl-Aufruf, eine Python-Version desselben Aufrufs sowie die Produktionsdetails, die vor dem Go-live bekannt sein sollten (Reasoning-Intensität, Streaming-Ausgabe, Fehlerbehandlung).

Vorbereitung

Ein hiapi-Konto und ein API-Schlüssel. Dieser lässt sich auf der Seite API Keys erstellen – alle hiapi-Modelle, einschließlich Claude Opus 5.5, teilen sich denselben Schlüssel.
Keine SDK-Installation erforderlich. Claude Opus 5.5 verwendet das OpenAI-kompatible Chat-Completions-Format von hiapi, sodass jeder HTTP-Client (curl, requests, fetch) sofort funktioniert.

Minimal funktionsfähige Anfrage (curl)

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

Die Modell-id wird direkt übergeben – weder ein Routing-Suffix noch ein Anbieter-Präfix ist erforderlich. Ein erfolgreicher Aufruf liefert ein standardmäßiges Chat-Completion-Objekt zurück:

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

Die Antwort liest man aus choices[0].message.content – hier gibt es kein output[0].url, auf das man warten müsste, und keine Task-id, die verfolgt werden müsste.

Derselbe Ablauf in Python

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

Da dieser Endpunkt das Übertragungsformat der OpenAI Chat Completions verwendet, lässt sich dieselbe Request-Body-Struktur unverändert in jedem HTTP-Client und in jeder Sprache nutzen – außer der Basis-URL und dem Bearer-Schlüssel gibt es nichts hiapi-Spezifisches zu lernen.

Reasoning-Intensität, Denken und Streaming-Ausgabe

Das erweiterte Denken von Claude Opus 5.5 ist immer aktiviert – man kann es weder deaktivieren noch ein Token-Budget manuell festlegen. Was man steuern kann, ist, wie viel Reasoning das Modell betreibt, und zwar über output_config.effort:

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort akzeptiert low, medium (der Standardwert, wenn das Feld weggelassen wird), high, xhigh oder max – und reicht von schnellen/kostengünstigen Antworten bis hin zu tiefgehenden, sorgfältig abgewogenen Antworten. Die message in der Antwort enthält ein Array reasoning_details, das den internen Gedankengang des Modells speichert; bei einfachen einmaligen Aufrufen kann man es getrost ignorieren und nur message.content lesen.

Bei längeren Antworten setzt man "stream": true, um inkrementelle Ausgabe zu erhalten, statt auf die vollständige Antwort zu warten:

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

Jeder Datenblock ist eine Zeile data: {...} im Format chat.completion.chunk, wobei der inkrementelle Text in choices[0].delta.content liegt. Man liest kontinuierlich Datenblöcke, bis ein Datenblock mit nicht-leerem finish_reason empfangen wird (üblicherweise "stop") – das ist das Ende der Antwort.

Claude Opus 5.5 unterstützt außerdem Tool-/Function-Calling, verfügt über ein Kontextfenster von 1 Million Token und eine Ausgabe von bis zu 128.000 Token, sodass es sich für große Codebasen oder Langdokument-Aufgaben eignet – nicht nur für kurze Frage-und-Antwort-Runden.

Hinweise für den Produktivbetrieb

Authentifizierungsfehler liefern 401, nicht 400. Bei fehlendem oder ungültigem Schlüssel wird zurückgegeben:
```
{ "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
```
Prüfen Sie gezielt auf HTTP 401 und geben Sie die request_id an, wenn Sie den Support kontaktieren müssen – zu weiteren Ursachen dieses Fehlers siehe die vollständige Anleitung zur Fehlerbehebung bei ungültigen API-Schlüsseln.
Hier gibt es keine Callback-/Webhook-Option. Dieses Muster gilt für die asynchronen Task-Modelle von hiapi (Bild, Video, Audio); Chat Completions unterstützt nur Request/Response, sodass stream: true neben einem einzelnen blockierenden Aufruf die einzige Option ist.
Dieser Aufruf ist von Natur aus idempotent – es wird keine Task-id versehentlich mehrfach erzeugt, daher sind Wiederholungsversuche nach Timeouts sicher, solange man damit einverstanden ist, denselben Prompt erneut auszuführen.
Achten Sie auf Rate-Limits, insbesondere bei hoher Parallelität; zur Backoff-Strategie siehe So behandeln Sie 429-Rate-Limit-Fehler.
Die Token-Preise (Eingabe-, Ausgabe- und Cache-Token werden getrennt abgerechnet) werden laufend auf der Claude Opus 5.5-Modellseite und der Preisseite aktualisiert – hartcodieren Sie keine Zahlen in Ihrer Abrechnungslogik, sondern lesen Sie sie von diesen Seiten.

Weiterführende Lektüre

Claude Opus 5.5-Modellseite – vollständige Spezifikationstabelle und Live-Preise
Claude Sonnet 4.6 API-Anleitung – die leichtere, schnellere Claude-Option im selben Chat-Completions-Format
Einen OpenAI-kompatiblen Proxy mit Python bauen – nützlich, wenn Sie mehrere Chat-Modelle hinter einer einzigen internen API proxen möchten
Ihre API-Schlüssel verwalten

Häufig gestellte Fragen

Unterstützt die Claude Opus 5.5 API Streaming-Ausgabe? Ja – setzen Sie "stream": true und lesen Sie die data: {...}-Datenblöcke wie oben beschrieben.

Benötigt man für den Aufruf von Claude Opus 5.5 in der Produktion einen API-Schlüssel? Ja. Jede Anfrage muss Authorization: Bearer sk-<your key> enthalten; die Produktions-API bietet keinen schlüssellosen oder anonymen Zugriff.

Kann ich das Denken von Claude Opus 5.5 deaktivieren, um Token zu sparen? Nein. Das Denken dieses Modells ist immer aktiviert; das Einzige, was Sie steuern können, ist die Stufe von output_config.effort (von low bis max), die zwischen Geschwindigkeit/Kosten und Tiefe abwägt.

Wird Claude Opus 5.5 wie die Bildmodelle von hiapi über /v1/tasks aufgerufen? Nein. Nur die Bild-, Video- und Audiomodelle von hiapi verwenden das asynchrone Task-plus-Polling-Muster. Claude Opus 5.5 ist ein Textmodell, verwendet /v1/chat/completions und liefert die Antwort in derselben Response zurück.

Wie groß sind Kontextfenster und maximale Ausgabelänge? 1 Million Token Kontext, bis zu 128.000 Token Ausgabe – ausreichend für ganze Repositories oder Langdokument-Prompts.

Unterstützt Claude Opus 5.5 Tool-/Function-Calling? Ja, ebenso Streaming-Ausgabe und das OpenAI-kompatible Nachrichtenformat.