> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Native Claude-API-Aufrufe

## Beschreibung

Die Modelle der Claude-Serie unterstützen offizielle native API-Aufrufe. Stellen Sie vor der Nutzung sicher, dass die `anthropic`-Abhängigkeit installiert oder aktualisiert ist:

```bash theme={null}
pip install -U anthropic
```

## Modellinformationen

| Modellname                    | Claude Opus 4.6                               | Claude Sonnet 4.6                             | Claude Sonnet 4.5 | Claude Haiku 4.5 |
| ----------------------------- | --------------------------------------------- | --------------------------------------------- | ----------------- | ---------------- |
| Unterstützt Extended Thinking | Ja                                            | Ja                                            | Ja                | Ja               |
| Größe des Kontextfensters     | 200K Token /<br />1M Token (Beta)<sup>3</sup> | 200K Token /<br />1M Token (Beta)<sup>3</sup> | 200K              | 200K             |
| Maximale Ausgabelänge         | 128K Token                                    | 128K Token                                    | 64K Token         | 64K Token        |
| Stichtag der Trainingsdaten   | August 2025                                   | August 2025                                   | Juli 2025         | Juli 2025        |

## Neue Funktionen in Claude 4.6

### Adaptive Thinking

Claude 4.6 empfiehlt den neuen Adaptive-Thinking-Modus, in dem Claude basierend auf der Komplexität der Frage automatisch entscheidet, ob und wie tief gedacht wird:

```python theme={null}
thinking={"type": "adaptive"}
```

<Warning>
  `thinking: {type: "enabled", budget_tokens: N}` ist in 4.6 veraltet und wird in zukünftigen Versionen entfernt.
</Warning>

### Automatische Kontextverdichtung (Beta)

Wenn sich Konversationen dem Kontextfenster-Limit nähern, kann Claude 4.6 ältere Inhalte serverseitig automatisch zusammenfassen und komprimieren.

**Vorteile:**

* Unterstützt sehr lange Konversationen
* Keine clientseitige Zusammenfassung nötig
* Verbessert die Fähigkeit von Agenten zu fortlaufenden Dialogen

**Hinweis:**

* Die automatische Verdichtung kann Details verlieren
* In Szenarien mit hoher Konsistenzanforderung sollte sie evaluativ getestet werden

### Veraltete Funktionen und Änderungen

* **`interleaved-thinking-2025-05-14`-Beta-Header entfernt:** In 4.6 unterstützt Adaptive Thinking nun automatisch Interleaved Thinking; es ist keine `extra_headers`-Angabe nötig. Bei weiterhin gesetztem Header wird dieser sicher ignoriert.

## Neue Funktionen in Claude 4

### Neuer Refusal-Stop-Reason

Das Claude-4-Modell führt den neuen Stop-Reason `refusal` ein, um Fälle zu behandeln, in denen das Modell aus Sicherheitsgründen die Generierung verweigert:

```json theme={null}
{
  "id": "msg_014XEDjypDjFzgKVWdFUXxZP",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [{"type": "text", "text": "I would be happy to assist you. You can "}],
  "stop_reason": "refusal",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 564,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 22
  }
}
```

Beim Migrieren auf Claude 4 sollten Sie Ihre Anwendung aktualisieren, um den Stop-Reason `refusal` zu behandeln.

### Extended Thinking

Mit aktiviertem Extended Thinking liefert die Messages-API des Claude-4-Modells eine Zusammenfassung des kompletten Denkprozesses. Die Zusammenfassung bietet alle intelligenten Vorteile von Extended Thinking und verhindert dennoch Missbrauch.

Die API bleibt zwischen Claude-3.7- und Claude-4-Modellen konsistent; die Streaming-Antwort für Extended Thinking kann jedoch im „Chunk"-Modus erfolgen, mit möglichen Verzögerungen zwischen Streaming-Events.

Die Zusammenfassung wird von einem anderen Modell als dem im Request angegebenen verarbeitet. Das Thinking-Modell sieht die Zusammenfassungsausgabe nicht.

### Interleaved Thinking

Das Claude-4-Modell unterstützt das Verschränken von Tool-Nutzung mit Extended Thinking, was natürlichere Konversationen ermöglicht, in denen Tool-Aufrufe und Antworten mit regulären Nachrichten gemischt werden können.

Interleaved Thinking befindet sich derzeit im Test. Um es zu aktivieren, fügen Sie den Test-Header `interleaved-thinking-2025-05-14` in Ihren API-Request ein:

```python theme={null}
extra_headers={
    "anthropic-beta": "interleaved-thinking-2025-05-14"
}
```

**Endpoint:** `POST` /v1/messages

## Aufruf

<CodeGroup>
  ```shell Curl theme={null}
  curl https://aihubmix.com/v1/messages \
       --header "x-api-key: $ANTHROPIC_API_KEY" \ # Replace with the key generated on AiHubMix
       --header "anthropic-version: 2023-06-01" \
       --header "content-type: application/json" \
       --data \
  '{
      "model": "claude-3-5-sonnet-20241022",
      "max_tokens": 1024,
      "messages": [
          {"role": "user", "content": "Hello, world"}
      ]
  }'
  ```

  ```py Python Non-streaming theme={null}
  import anthropic

  client = anthropic.Anthropic(
      api_key="sk-***", # Replace with the key generated on AiHubMix
      base_url="https://aihubmix.com"
  )
  message = client.messages.create(
      model="claude-3-5-sonnet-20241022",
      max_tokens=1024,
      messages=[
          {"role": "user", "content": "Hello, Claude"}
      ]
  )
  print(message.content)
  ```

  ```py Python Streaming 128K theme={null}
  import anthropic

  client = anthropic.Anthropic(
      api_key="sk-***", # Replace with the key generated on AiHubMix
      base_url="https://aihubmix.com"
  )

  with client.messages.stream(
      model="claude-3-7-sonnet-20250219",  # claude-opus-4-20250514, claude-sonnet-4-20250514
      max_tokens=128000,
      messages=[
          {"role": "user", "content": "Please generate a 100,000 token article that elaborates on Charlie Munger's 100 mental models (approximately 1,000 tokens for each model), with each section including an introduction to the model, multidimensional thinking, application methods, practical blind spots, and specific examples. Clarity and engagement are key. Use bullet points only when necessary."}
      ],
      extra_headers={
          "anthropic-beta": "output-128k-2025-02-19"
      }
  ) as stream:
      for text in stream.text_stream:
          print(text, end="", flush=True)
  ```

  ```py Python Interleaved Thinking theme={null}
  import anthropic

  client = anthropic.Anthropic(
      api_key="sk-***", # Replace with the key generated on AiHubMix
      base_url="https://aihubmix.com"
  )

  response = client.messages.create(
      model="claude-sonnet-4-20250514",  # or claude-opus-4-20250514
      max_tokens=1024,
      messages=[
          {"role": "user", "content": "Help me analyze this data and generate a chart"}
      ],
      tools=[
          {
              "type": "computer_20241022",
              "name": "computer"
          }
      ],
      extra_headers={
          "anthropic-beta": "interleaved-thinking-2025-05-14"
      }
  )
  print(response.content)
  ```
</CodeGroup>

### Aufbau des Body-Requests

```json theme={null}
{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
}
```

### Request-Parameter

| Name          | Position | Typ       | Pflicht | Beschreibung       |
| ------------- | -------- | --------- | ------- | ------------------ |
| x-api-key     | header   | string    | Nein    | AIHUBMIX\_API\_KEY |
| Content-Type  | header   | string    | Nein    | keine              |
| body          | body     | object    | Nein    | keine              |
| » model       | body     | string    | Ja      | keine              |
| » messages    | body     | \[object] | Ja      | keine              |
| »» role       | body     | string    | Nein    | keine              |
| »» content    | body     | string    | Ja      | keine              |
| » max\_tokens | body     | number    | Ja      | keine              |

### Antwortbeispiel

```json theme={null}
200 Response
```

```json theme={null}
{
  "id": "msg_013Uf6CwwyjSe35n3yVaPbLM",
  "type": "message",
  "role": "assistant",
  "model": "claude-3-5-sonnet-20241022",
  "content": [
    {
      "type": "text",
      "text": "That's one of humanity's most enduring and complex philosophical questions! While there's no universal answer, I aim to explore such questions thoughtfully while acknowledging their complexity. I try to focus on having meaningful conversations and helping where I can. What does meaning in life mean to you?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 61
  }
}
```

### Antworten

| Statuscode | Bedeutung | Beschreibung | Datenmodell |
| ---------- | --------- | ------------ | ----------- |
| 200        | OK        | keine        | Inline      |

## Migration auf Claude 4

Beim Wechsel von Claude 3.7 auf Claude 4 sollten Sie folgende Änderungen beachten:

### Modellnamen aktualisieren

```python theme={null}
# From Claude 3.7
model="claude-3-7-sonnet-20250219"

# Migrate to Claude 4
model="claude-sonnet-4-20250514"  # or "claude-opus-4-20250514"
```

### Neue Stop-Reasons behandeln

Aktualisieren Sie Ihre Anwendung, um den neuen `refusal`-Stop-Reason zu behandeln:

```python theme={null}
if response.stop_reason == "refusal":
    print("Claude refuses to generate this content")
elif response.stop_reason == "end_turn":
    print("Completed normally")
```

### Nicht unterstützte Funktionen entfernen

* **Token Efficient Tool Usage:** Nur in Claude Sonnet 3.7 verfügbar, in Claude 4 nicht mehr unterstützt
* **Extended Output:** Der Test-Header `output-128k-2025-02-19` ist nur in Claude Sonnet 3.7 verfügbar

Falls Sie von Claude Sonnet 3.7 migrieren, wird empfohlen, folgende Test-Header aus Ihren Requests zu entfernen:

```python theme={null}
# Remove these headers (if present)
# "token-efficient-tools-2025-02-19"
# "output-128k-2025-02-19"
```

## Verwendung in Anwendungen (Beispiel mit Lobe-Chat)

* Öffnen Sie die Einstellungsseite und wählen Sie als Modellanbieter Claude
* Geben Sie den API-Schlüssel von [unserer Website](https://aihubmix.com/token) ein
* Setzen Sie als API-Proxy-Adresse direkt:

```
https://aihubmix.com
```

* Empfohlen wird die Aktivierung von „Use Client Request Mode"
* Fügen Sie schließlich die gewünschten Modelle in die Modellliste ein (empfohlen wird, den Modellnamen aus der Einstellungsseite unserer Website zu kopieren)\\

  <img src="https://mintcdn.com/aihubmix/_Cbum_77AgsRh-CI/public/cn/cla1.png?fit=max&auto=format&n=_Cbum_77AgsRh-CI&q=85&s=a85f2cfa7552e99badbc69a9a8af8295" alt="Bild" width="1225" height="613" data-path="public/cn/cla1.png" />

  <img src="https://mintcdn.com/aihubmix/_Cbum_77AgsRh-CI/public/cn/cla2.png?fit=max&auto=format&n=_Cbum_77AgsRh-CI&q=85&s=c18c5b40b30b914a185629cb708735ba" alt="Bild" width="1102" height="699" data-path="public/cn/cla2.png" />

## Claude-Texteditor-Tools

Claude kann mit von Anthropic definierten Texteditor-Tools Textdateien anzeigen und bearbeiten, um Sie beim Debuggen, Reparieren und Verbessern von Code oder anderen Textdokumenten zu unterstützen. Damit kann Claude direkt mit Ihren Dateien interagieren und nicht nur Vorschläge geben, sondern praktische Aktionen ausführen.

### Vorbereitung vor der Nutzung der Texteditor-Tools

Wählen Sie kompatible Modelle. Anthropics Texteditor-Tools unterstützen folgende Claude-Modelle:

* **Claude-4-Serie** (`claude-opus-4-20250514`, `claude-sonnet-4-20250514`): `text_editor_20250429`
* **Claude 3.7 Sonnet** (`claude-3-7-sonnet-20250219`): `text_editor_20250124`
* **Claude 3.5 Sonnet** (`claude-3-5-sonnet-20241022`): `text_editor_20241022`

<Warning>
  Claude-4-Modelle verwenden ein völlig neues Texteditor-Tool, das nicht mit älteren Versionen kompatibel ist. Stellen Sie sicher, dass Sie den korrekten Tool-Typ und -Namen verwenden.
</Warning>

### Tool-Konfiguration pro Modell

| Modellversion          | Tool-Typ               | Tool-Name                     | Unterstützte Funktionen                |
| ---------------------- | ---------------------- | ----------------------------- | -------------------------------------- |
| Claude 4 (Opus/Sonnet) | `text_editor_20250429` | `str_replace_based_edit_tool` | view, str\_replace, create             |
| Claude 3.7 Sonnet      | `text_editor_20250124` | `str_replace_editor`          | view, str\_replace, create, undo\_edit |
| Claude 3.5 Sonnet      | `text_editor_20241022` | `str_replace_editor`          | view, str\_replace, create, undo\_edit |

<Tip>
  **Wichtige Änderung:** Das Claude-4-Modell unterstützt den Befehl `undo_edit` nicht mehr. Bitte entfernen Sie Abhängigkeiten von dieser Funktion aus Ihrem Code.
</Tip>

### Anwendungsfälle bewerten

Typische Szenarien für die Nutzung der Texteditor-Tools:

* Code-Debugging: Hilft, Probleme im Code zu identifizieren und zu beheben – von Syntaxfehlern bis zu logischen Problemen.
* Code-Refactoring: Verbessert Struktur, Lesbarkeit und Performance durch gezielte Edits.
* Dokumentationserstellung: Fügt Docstrings, Kommentare oder README-Dateien zu Ihrer Codebasis hinzu.
* Testerstellung: Erstellt Unit-Tests auf Basis des Verständnisses der Implementierung.

### Texteditor-Tools verwenden

Stellen Sie Claude über die Messages-API Texteditor-Tools (Name `str_replace_editor`) zur Verfügung. Sie benötigen das `anthropic`-Paket:

```shell theme={null}
pip install anthropic
```

**Aufrufbeispiele:**

<CodeGroup>
  ```python Python-Claude 4 theme={null}
  import anthropic

  client = anthropic.Anthropic(
      api_key="sk-***", # Replace with the key generated on AiHubMix
      base_url="https://aihubmix.com"
  )

  response = client.messages.create(
      model="claude-sonnet-4-20250514",  # or claude-opus-4-20250514
      max_tokens=1024,
      tools=[
          {
              "type": "text_editor_20250429",
              "name": "str_replace_based_edit_tool"
          }
      ],
      messages=[
          {
              "role": "user", 
              "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
          }
      ]
  )

  print("Response content:")
  for message in response.content:
      print(message.text)
  ```

  ```py Python-Claude 3.7 theme={null}
  import anthropic

  client = anthropic.Anthropic(
      api_key="sk-***", # Replace with the key generated on AiHubMix
      base_url="https://aihubmix.com"
  )

  response = client.messages.create(
      model="claude-3-7-sonnet-20250219",
      max_tokens=1024,
      tools=[
          {
              "type": "text_editor_20250124",
              "name": "str_replace_editor"
          }
      ],
      messages=[
          {
              "role": "user", 
              "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
          }
      ]
  )

  print("Response content:")
  for message in response.content:
      print(message.text)
  ```

  ```shell Curl-Claude 4 theme={null}
  curl -X POST https://aihubmix.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: xxx" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "claude-sonnet-4-20250514",
      "max_tokens": 1024,
      "tools": [
        {
          "type": "text_editor_20250429",
          "name": "str_replace_based_edit_tool"
        }
      ],
      "messages": [
        {
          "role": "user",
          "content": "There'\''s a syntax error in my primes.py file. Can you help me fix it?"
        }
      ]
    }'
  ```

  ```shell Curl-Claude 3.7 theme={null}
  curl -X POST https://aihubmix.com/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: xxx" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "claude-3-7-sonnet-20250219",
      "max_tokens": 1024,
      "tools": [
        {
          "type": "text_editor_20250124",
          "name": "str_replace_editor"
        }
      ],
      "messages": [
        {
          "role": "user",
          "content": "There'\''s a syntax error in my primes.py file. Can you help me fix it?"
        }
      ]
    }'
  ```
</CodeGroup>

### Migration auf Claude 4 (Texteditor-Tools)

Beim Wechsel von Claude 3.7 Sonnet auf Claude-4-Modelle beachten Sie:

#### Tool-Konfiguration aktualisieren

```py python theme={null}
# Claude 3.7 Sonnet
tools=[
    {
        "type": "text_editor_20250124",
        "name": "str_replace_editor"
    }
]

# Claude 4 (Opus/Sonnet)
tools=[
    {
        "type": "text_editor_20250429",
        "name": "str_replace_based_edit_tool"
    }
]
```

#### Nicht unterstützte Funktionen entfernen

* **`undo_edit`-Befehl**: Das Claude-4-Modell unterstützt die Undo-Edit-Funktion nicht mehr.
* Entfernen Sie jegliche `undo_edit`-Abhängigkeiten aus Ihrem Code.

Antwortbeispiel:

```json theme={null}
{
  "id": "msg_bdrk_012xyNaFCQg4zsVcTk5VkDAe",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "I'd be happy to help you fix the syntax error in your `primes.py` file. First, let me take a look at the file to identify the issue."
    },
    {
      "type": "tool_use",
      "text": "",
      "id": "toolu_bdrk_01P6jQG6suDSsDjzugqGVHWC",
      "name": "str_replace_based_edit_tool",
      "input": {
        "command": "view",
        "path": "/repo/primes.py"
      }
    }
  ],
  "model": "claude-sonnet-4-20250514",
  "stop_reason": "tool_use",
  "usage": {
    "input_tokens": 1042,
    "output_tokens": 115
  }
}
```

***

Zuletzt aktualisiert: 2026-06-01
