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

# Empfohlene Modelle

> Wählen Sie das richtige LLM für Ihre FIM One-Bereitstellung.

FIM One ist **anbieteragnostisch** — jeder OpenAI-kompatible Endpunkt funktioniert. Diese Seite hilft Ihnen, die beste Modellkombination für Ihren Anwendungsfall auszuwählen. Konfigurationsdetails finden Sie unter [Umgebungsvariablen](/configuration/environment-variables).

## Wie FIM One Modelle nutzt

FIM One hat drei Modellrollen:

| Rolle         | Umgebungsvariable     | Verwendet für                                                      |
| ------------- | --------------------- | ------------------------------------------------------------------ |
| **General**   | `LLM_MODEL`           | Planung, Analyse, ReAct-Agent, komplexes Reasoning                 |
| **Fast**      | `FAST_LLM_MODEL`      | DAG-Schrittausführung, Kontextkomprimierung (günstiger, schneller) |
| **Reasoning** | `REASONING_LLM_MODEL` | Tiefe Analyse, komplexe Planung, mathematische Beweise             |

Fast und Reasoning fallen auf General zurück, falls nicht konfiguriert. Für Produktionsbereitstellungen bietet die Aufteilung in mindestens zwei Modelle (General + Fast) das beste Kosten-/Qualitätsverhältnis.

Diese Rollen können über Umgebungsvariablen oder über die Funktion **Model Groups** der Admin-Benutzeroberfläche konfiguriert werden, die Ein-Klick-Umschaltung zwischen Modellsätzen ermöglicht. Siehe [Model Management](/configuration/model-management) für das vollständige Admin-UI-Handbuch.

## Quick Selection Matrix

| Provider            | Main LLM                                    | Fast LLM                                      | Reasoning                          | Vision          | Notes                                                                    |
| ------------------- | ------------------------------------------- | --------------------------------------------- | ---------------------------------- | --------------- | ------------------------------------------------------------------------ |
| **OpenAI**          | `gpt-5.4`                                   | `gpt-5.4-mini` / `gpt-5.4-nano`               | ✅ `reasoning_effort`               | ✅ All           | Best native tool-calling; GPT-5.4 is latest flagship (Mar 2026)          |
| **Anthropic**       | `claude-sonnet-4-6`                         | `claude-haiku-4-5`                            | ✅ via LiteLLM                      | ✅ All           | Native API routing; full `reasoning_content` support; 1M context GA      |
| **Google Gemini**   | `gemini-2.5-pro` / `gemini-3.1-pro-preview` | `gemini-2.5-flash` / `gemini-3-flash-preview` | ✅ `reasoning_effort`               | ✅ All           | 2.5 is stable GA; 3.x is preview; `gemini-3-pro-preview` shut down Mar 9 |
| **DeepSeek**        | `deepseek-chat` (V3.2)                      | `deepseek-chat`                               | ✅ `deepseek-reasoner`              | ❌               | Text-only; V4 (Apr 2026) will add vision                                 |
| **Qwen (Alibaba)**  | `qwen3.5-plus` / `qwen3-max`                | `qwen3.5-flash` / `qwen-turbo`                | ✅ `enable_thinking` on `qwen3-max` | ⚠️ qwen3.5 only | Strongest Chinese language; qwq/reasoning text-only                      |
| **ChatGLM (Zhipu)** | `glm-4.7`                                   | `glm-4.7-flash`                               | `glm-5`                            | ⚠️ GLM-4.6V     | Forced FC not supported; vision requires separate VLM model              |
| **MiniMax**         | `MiniMax-M2.7`                              | `MiniMax-M2.5`                                | ❌                                  | ❌               | Text-only; M2.7 latest (Mar 2026); 80.2% SWE-Bench                       |
| **Kimi (Moonshot)** | `kimi-k2.5`                                 | `kimi-k2`                                     | ✅ `kimi-k2-thinking`               | ⚠️ K2.5 only    | K2-thinking text-only; forced FC not supported with thinking             |
| **Ollama (local)**  | `qwen3.5` / `llama4`                        | `qwen3.5:9b`                                  | ❌                                  | Varies          | Fully offline, no API key; Llama 4 supports vision                       |

<Tip>
  **Vision** gibt an, ob das Modell Bildeingaben akzeptiert. Dies ist erforderlich für [Intelligent Document Processing (IDP)](/features/idp) — wenn Ihr Modell Vision nicht unterstützt, greift IDP auf reine Textextraktion zurück. Anbieter, die mit ⚠️ gekennzeichnet sind, haben Vision auf einigen Modellen, aber nicht auf anderen; überprüfen Sie das spezifische Modell, das Sie verwenden.

  Chat-Anhänge folgen demselben Flag: Bei einem reinen Textmodell wird ein angehängtes Bild nicht gesendet, und das Modell erhält nur seinen Dateinamen. Der Chat-Composer teilt dies mit, bevor Sie senden, basierend auf dem Modell, das der Turn tatsächlich verwenden würde (Agent-Einstellung, dann die aktive Modellgruppe, dann der Systemstandard). Dokumenttext ist nicht betroffen — eine PDF oder DOCX hat ihren Inhalt weiterhin extrahiert und eingefügt.
</Tip>

Diese Tabelle listet die Kombinationen auf, die wir empfehlen, nicht die vollständige Menge der Anbieter, die FIM One unterstützt. xAI (Grok), ByteDance Doubao, Mistral und jedes OpenAI-kompatible Relay funktionieren; siehe die [Provider Capability Matrix](/architecture/llm-provider-guide#provider-capability-matrix) für die vollständige Liste und wie jeder weitergeleitet wird.

## Strukturierte Ausgabekompatibilität

FIM Ones DAG-Planer benötigt, dass das Modell gültiges strukturiertes JSON zurückgibt. Intern versucht es drei Extraktionsebenen in dieser Reihenfolge:

1. **Native Function Calling** — zwingt das Modell, JSON auszugeben, das einem Schema über die Tool-Call-API entspricht. Am zuverlässigsten.
2. **JSON Mode** — fordert `response_format: json_object` an. Garantiert gültiges JSON, erzwingt aber keine Schemakonformität.
3. **Plain Text Extraction** — analysiert JSON aus Freitext als letzten Ausweg.

Modelle, die Level 1 (natives FC mit erzwungenem `tool_choice`) unterstützen, bieten die beste Planungszuverlässigkeit. Wenn ein Modell nur Level 2 erreicht, hängt seine Ausgabequalität davon ab, wie gut es den Anweisungen folgt — schwächere Modelle können gültiges JSON produzieren, das nicht der erwarteten Struktur entspricht.

| Anbieter                    | Erzwungenes Function Calling                                                                   | JSON Mode | Planungszuverlässigkeit                                    |
| --------------------------- | ---------------------------------------------------------------------------------------------- | --------- | ---------------------------------------------------------- |
| **OpenAI** (GPT-5.x, o3)    | ✅ Vollständige Unterstützung                                                                   | ✅         | ⭐⭐⭐ Ausgezeichnet                                          |
| **Anthropic** (Claude 4.x)  | ⚠️ Konflikte mit Thinking-Modus                                                                | ✅         | ⭐⭐⭐ Ausgezeichnet (starke Anweisungsbefolgung kompensiert) |
| **Google Gemini** (2.5/3.x) | ✅ Vollständige Unterstützung                                                                   | ✅         | ⭐⭐⭐ Ausgezeichnet                                          |
| **Mistral**                 | ✅ Vollständige Unterstützung                                                                   | ✅         | ⭐⭐ Gut                                                     |
| **xAI** (Grok 4.1)          | ✅ Vollständige Unterstützung                                                                   | ✅         | ⭐⭐ Gut                                                     |
| **DeepSeek** (V3.2)         | ✅ auf `deepseek-chat`; ❌ auf `deepseek-reasoner`, dessen Thinking-Modus lehnt es ab            | ✅         | ⭐⭐ Gut                                                     |
| **Qwen** (3.x)              | ✅ Unterstützt                                                                                  | ✅         | ⭐⭐ Gut                                                     |
| **ByteDance** (Doubao Seed) | ✅ Vollständige Unterstützung                                                                   | ✅         | ⭐⭐ Gut                                                     |
| **Kimi** (K2.5)             | ⚠️ Mit Thinking nur `auto` unterstützt; erzwungene Tool-Wahl benötigt Thinking aus (`kimi-k2`) | ✅         | ⭐ Befriedigend — kann fehlerhafte Pläne produzieren        |
| **ChatGLM** (GLM-4.7/5)     | ❌ Nicht unterstützt (`auto` nur)                                                               | ✅         | ⭐ Befriedigend                                             |
| **MiniMax** (M2.5/M2.7)     | ✅ Vollständige Unterstützung, Thinking zum Trotz                                               | ✅         | ⭐⭐ Gut                                                     |
| **Lokal (Ollama)**          | Variiert je nach Modell                                                                        | Variiert  | ⭐ Befriedigend — 32B+ empfohlen                            |

Diese Tabelle ist eine Entscheidungshilfe. Die autoritative, codegebundene Version, einschließlich welche `tool_choice`-Zustände jeder Anbieter akzeptiert und was FIM One tut, wenn einer abgelehnt wird, ist die [Provider Capability Matrix](/architecture/llm-provider-guide#provider-capability-matrix).

<Tip>
  Wenn Sie den Fehler „failed to generate a valid task plan" sehen, ist die strukturierte Ausgabefähigkeit des Modells für DAG-Planung unzureichend. Wechseln Sie Ihr **Main LLM** zu einem Modell mit einer Bewertung von ⭐⭐⭐ oder ⭐⭐ oder höher, oder deaktivieren Sie den DAG-Modus und verwenden Sie stattdessen den einfacheren ReAct-Agenten.
</Tip>

## Thinking / Reasoning Kompatibilität

Verschiedene Anbieter implementieren "Thinking" (Chain-of-Thought-Reasoning) auf grundlegend unterschiedliche Weise. Dies ist wichtig, da der Thinking-Modus mit Tool-Aufrufen in Konflikt geraten kann und die Ausgabe je nach Anbieter an verschiedenen Stellen erscheint. FIM One handhabt all dies transparent — diese Tabelle hilft dir zu verstehen, was unter der Haube passiert.

### Schlüsselkonzepte

* **Opt-in** — Denken ist standardmäßig deaktiviert; Sie aktivieren es über einen API-Parameter (z. B. `reasoning_effort`). Kann selektiv pro Aufruf deaktiviert werden.
* **Always-on** — das Modell denkt immer; es gibt keinen API-Parameter, um es auszuschalten. Sie müssten zu einer Modellvariante ohne Denken wechseln, um es zu vermeiden.
* **Modell-Ebene** — Denken wird durch die Modell-ID bestimmt, die Sie wählen (z. B. `deepseek-reasoner` vs `deepseek-chat`), nicht durch einen Parameter.

### Kompatibilitätsmatrix

| Anbieter                    | Aktivierung                                     | Deaktivierbar?  | Thinking-Ausgabe                               | Erzwungener FC-Konflikt?                                                                                                                |
| --------------------------- | ----------------------------------------------- | --------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **OpenAI** (GPT-5.x)        | `reasoning_effort` param                        | ✅ Opt-in        | Intern (nicht für Benutzer sichtbar)           | ✅ Tools + Reasoning laufen zusammen über die Responses API (automatisch; chat-completions Fallback erzwingt `reasoning_effort: "none"`) |
| **OpenAI** (o-series)       | Immer aktiviert                                 | ❌               | Intern (Tokens gezählt, nicht zurückgegeben)   | ✅ Kein Konflikt                                                                                                                         |
| **Anthropic** (Claude 4.x)  | `reasoning_effort` → `thinking`                 | ✅ Opt-in        | API `reasoning_content` Feld → Reasoning-Panel | ❌ Erzwungener FC + Thinking = **400 Fehler**                                                                                            |
| **Google Gemini** (2.5/3.x) | `reasoning_effort` param                        | ✅ Opt-in        | Intern                                         | ✅ Kein Konflikt                                                                                                                         |
| **DeepSeek**                | Modellvariante (`deepseek-reasoner`)            | Auf Modellebene | API `reasoning_content` Feld → Reasoning-Panel | ❌ Bei `deepseek-reasoner` abgelehnt, bei `deepseek-chat` akzeptiert                                                                     |
| **Qwen** (3.x)              | `enable_thinking` param, anbieterseitig gesetzt | ✅ Opt-in        | `<think>` Tags im Inhalt                       | ✅ Kein Konflikt                                                                                                                         |
| **MiniMax** (M2.7)          | Immer aktiviert                                 | ❌               | `<think>` Tags im Inhalt                       | ✅ Kein Konflikt                                                                                                                         |
| **ChatGLM** (GLM-5)         | Modellvariante                                  | Auf Modellebene | Nicht externalisiert                           | ❌ Erzwungener FC nicht unterstützt, mit oder ohne Thinking                                                                              |
| **Kimi** (K2-thinking)      | Modellvariante                                  | Auf Modellebene | API-Feld                                       | ❌ Mit aktiviertem Thinking nur `auto` unterstützt                                                                                       |

Die anbieterorientierte Detailinformation hinter dieser Tabelle, einschließlich der Übersetzung jeder `effort`-Stufe und ob Reasoning in späteren Durchläufen wiedergegeben wird, befindet sich in [Tabelle C der Provider-Capability-Matrix](/architecture/llm-provider-guide#provider-capability-matrix).

### Wie FIM One jeden Fall handhabt

**API-Level `reasoning_content`** (Claude, DeepSeek): Das Reasoning-Feld wird direkt aus der API-Antwort gelesen und im UI Reasoning-Panel angezeigt. Keine Nachbearbeitung erforderlich.

**`<think>` Tags im Content** (MiniMax, Qwen, QwQ und andere Open-Source-Derivate): FIM One entfernt automatisch `<think>...</think>` Tags aus dem Content-Feld und leitet den Thinking-Text zum Reasoning-Panel um. Dies funktioniert sowohl für Streaming- als auch für Non-Streaming-Antworten.

**Erzwungene FC + Thinking-Konflikte** sind pro Provider, nicht eine Eigenschaft von Thinking-Modellen im Allgemeinen. Claude lehnt die Kombination ab, aber sein Thinking ist optional, daher deaktiviert FIM One das Thinking für diesen einen Aufruf, indem es `reasoning_effort=None` übergibt und das native Function Calling fortgesetzt wird. Kimi lehnt es ebenfalls ab, und sein Thinking wird durch die Modell-ID statt durch einen Parameter ausgewählt, daher besteht die Lösung darin, Native Function Calling für die Thinking-Modelle zu deaktivieren. MiniMax denkt bei jedem Aufruf und akzeptiert erzwungenes Function Calling trotzdem, weshalb keine Problemumgehung darauf anwendbar ist.

**Fallback-Kette**: Wenn erzwungenes Function Calling aus irgendeinem Grund fehlschlägt, fällt FIM One automatisch zurück: Native FC → JSON-Modus → Plain-Text-Extraktion. Dieser dreistufige Ansatz stellt sicher, dass die Planung auch bei Providern mit teilweiser Tool-Calling-Unterstützung funktioniert.

<Note>
  Wenn Sie ein Modell verwenden, das immer denkt (MiniMax M2.7, `deepseek-reasoner`) als Ihr Main LLM, wird die Thinking-Ausgabe in jedem Reasoning-Panel der Agent-Iteration angezeigt. Dies ist normal — es beeinträchtigt die Funktionalität nicht, und Sie können den Reasoning-Prozess des Modells sehen.
</Note>

## Anbieterdetails

### OpenAI

Die am meisten bewährte Option. OpenAI-Modelle haben die beste native Unterstützung für Funktionsaufrufe (Tool-Calling), was sich direkt auf die Zuverlässigkeit von Agenten auswirkt. Die GPT-5-Familie (August 2025+) stellt einen großen generationalen Sprung gegenüber GPT-4 dar.

**Empfohlene Modelle:**

* Main: `gpt-5.4` (neuestes Flaggschiff, März 2026 — 1M+ Kontext, Computer Use) oder `o3` (beste Reasoning-Genauigkeit)
* Fast: `gpt-5.4-mini` ($0,75/$4,50 pro MTok) oder `gpt-5.4-nano` (günstigste mit $0,20/$1,25 pro MTok)
* Budget Fast: `gpt-5-mini` ($0,25/$2,00) und `gpt-5-nano` ($0,05/$0,40) bleiben zu niedrigeren Preisen verfügbar
* Legacy: `gpt-4.1` (noch in der API, 1M Kontext, gut für Coding)

**Reasoning:** Setzen Sie `LLM_REASONING_EFFORT=medium` — funktioniert nativ mit o-Series und GPT-5.x-Modellen. GPT-5.4 unterstützt `reasoning_effort` mit den Stufen `none`, `low`, `medium`, `high`, `xhigh`. Die o-Series erfordert `max_completion_tokens` statt `max_tokens`, was LiteLLM automatisch handhabt. Hinweis: `/v1/chat/completions` lehnt GPT-5.x-Anfragen ab, die Tools mit Reasoning kombinieren, daher spricht FIM One direkt die Responses API für GPT-5.x an, wo beide zusammen funktionieren. Dieser Pfad trägt auch das verschlüsselte Reasoning jeder Runde in die nächste, sodass ein Agent, der eine mehrstufige Antwort aufbaut, das bereits Erarbeitete behält, statt es bei jedem Tool-Aufruf neu herzuleiten. Endpunkte ohne `/v1/responses`-Route fallen auf Chat Completions mit explizitem `reasoning_effort: "none"` während der Agent-Tool-Use-Schritte zurück, und `FIM_GPT5_RESPONSES_MODE` kann entweder Fallback manuell erzwingen. Andere Modellfamilien auf OpenAI-kompatiblen Endpunkten bleiben bei Chat Completions: Sie gewinnen nichts von Responses, und Proxy-Shims dafür können das Streaming schlecht puffern. GPT-5.4 erfordert `temperature=1`, was FIM One automatisch über LiteLLMs Parameterfilterung (`drop_params`) handhabt.

| Modell         | Input \$/MTok | Output \$/MTok | Kontext                  |
| -------------- | ------------- | -------------- | ------------------------ |
| `gpt-5.4`      | \$2,50        | \$15,00        | 1.050K (Aufschlag >272K) |
| `gpt-5.4-mini` | \$0,75        | \$4,50         | 400K                     |
| `gpt-5.4-nano` | \$0,20        | \$1,25         | 400K                     |
| `o3`           | \$2,00        | \$8,00         | 200K                     |
| `o4-mini`      | \$1,10        | \$4,40         | 200K                     |
| `gpt-5-mini`   | \$0,25        | \$2,00         | 400K                     |
| `gpt-5-nano`   | \$0,05        | \$0,40         | 400K                     |

```bash theme={null}
# .env — OpenAI (production with reasoning)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-5.4
FAST_LLM_MODEL=gpt-5.4-nano
LLM_REASONING_EFFORT=medium
```

```bash theme={null}
# .env — OpenAI (budget reasoning)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=o3
FAST_LLM_MODEL=gpt-5.4-nano
LLM_REASONING_EFFORT=medium
```

***

### Anthropic (Claude)

Claude zeichnet sich durch differenzierte Argumentation und komplexe mehrstufige Aufgaben aus. FIM One verbindet sich über [LiteLLM](https://github.com/BerriAI/litellm), das Anthropic-Modelle automatisch über deren native API weiterleitet. Die aktuelle Generation ist Claude 4.6 (Februar 2026).

**Empfohlene Modelle:**

* Main: `claude-sonnet-4-6` (beste Balance zwischen Leistung und Kosten — $3/$15 pro MTok)
* Fast: `claude-haiku-4-5` (schnell und günstig — $1/$5 pro MTok)
* Premium: `claude-opus-4-6` (am leistungsfähigsten, 128K maximale Ausgabe — $5/$25 pro MTok)

**Basis-URL:** `https://api.anthropic.com/v1/`

Opus 4.6 und Sonnet 4.6 haben ein 1M-Kontextfenster (GA seit 13. März 2026 — kein Beta-Header erforderlich). Haiku 4.5 hat ein 200K-Kontextfenster.

**Reasoning:** Setzen Sie `LLM_REASONING_EFFORT=medium`. LiteLLM leitet Anthropic-Modelle über die native API weiter, sodass `reasoning_content` (erweitertes Denken) vollständig zurückgegeben und im UI-Schritt „thinking" sichtbar ist. Claude 4.6 und neuer verwenden Adaptive Thinking (`thinking: {type: "adaptive"}` plus `output_config.effort`) anstelle eines manuellen `budget_tokens`, das FIM One direkt ausgibt, anstatt sich auf LiteLLMs Zuordnung zu verlassen. Anthropic erfordert `temperature=1` während das Denken aktiv ist, und das System erzwingt das für Sie: der Request Builder fixiert den Wert auf Anthropic-Routen, und bei Modellen, die Sampling-Parameter ablehnen, entfernt er `temperature` vollständig. Setzen Sie nicht manuell `LLM_TEMPERATURE=1`. Weitere Informationen finden Sie unter [Extended Thinking](/configuration/environment-variables#extended-thinking-reasoning).

```bash theme={null}
# .env — Anthropic Claude
LLM_API_KEY=sk-ant-...
LLM_BASE_URL=https://api.anthropic.com/v1/
LLM_MODEL=claude-sonnet-4-6
FAST_LLM_MODEL=claude-haiku-4-5
LLM_REASONING_EFFORT=medium
```

***

### Google Gemini

Gemini-Modelle bieten starke Leistung zu wettbewerbsfähigen Preisen über Googles OpenAI-kompatiblen Endpunkt. Die 3.x-Generation (Ende 2025+) ist ein großer Sprung — Gemini 3 Flash übertrifft 2.5 Pro und ist dabei 3x schneller. Hinweis: `gemini-3-pro-preview` wurde am 9. März 2026 abgeschaltet — verwenden Sie stattdessen `gemini-3.1-pro-preview`.

**Empfohlene Modelle:**

* Stabil (GA): `gemini-2.5-pro` (Hauptmodell) + `gemini-2.5-flash` (schnell) — produktionsreif
* Neueste (Vorschau): `gemini-3.1-pro-preview` (Hauptmodell) + `gemini-3-flash-preview` (schnell) + `gemini-3.1-flash-lite-preview` (Budget schnell) — beste Leistung, aber Vorschaustatus

**Basis-URL:** `https://generativelanguage.googleapis.com/v1beta/openai/`

**Reasoning:** `reasoning_effort` wird auf dem Kompatibilitäts-Endpunkt unterstützt — setzen Sie `LLM_REASONING_EFFORT=medium` und es funktioniert sofort.

| Modell                          | Input \$/MTok | Output \$/MTok | Status               |
| ------------------------------- | ------------- | -------------- | -------------------- |
| `gemini-3.1-pro-preview`        | \$2.00        | \$12.00        | Vorschau             |
| `gemini-3-flash-preview`        | \$0.50        | \$3.00         | Vorschau             |
| `gemini-3.1-flash-lite-preview` | \$0.25        | \$1.50         | Vorschau (März 2026) |
| `gemini-2.5-pro`                | \$1.25        | \$10.00        | Stabil GA            |
| `gemini-2.5-flash`              | \$0.30        | \$2.50         | Stabil GA            |
| `gemini-2.5-flash-lite`         | \$0.10        | \$0.40         | Stabil GA            |

```bash theme={null}
# .env — Gemini (stable)
LLM_API_KEY=AIza...
LLM_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
LLM_MODEL=gemini-2.5-pro
FAST_LLM_MODEL=gemini-2.5-flash
LLM_REASONING_EFFORT=medium
```

```bash theme={null}
# .env — Gemini (latest preview)
LLM_API_KEY=AIza...
LLM_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
LLM_MODEL=gemini-3.1-pro-preview
FAST_LLM_MODEL=gemini-3-flash-preview
LLM_REASONING_EFFORT=medium
```

***

### DeepSeek

DeepSeek bietet das beste Kosten-Leistungs-Verhältnis auf dem Markt. V3.2 (Dezember 2025) vereinigte die Chat- und Reasoning-Linien in einem einzigen Modell mit unglaublich niedrigen Preisen.

**Modell-IDs** (beide unterstützt durch V3.2):

* `deepseek-chat` — Allzweck (Non-Thinking-Modus)
* `deepseek-reasoner` — Chain-of-Thought-Reasoning-Modus, gibt `reasoning_content` zurück

**Basis-URL:** `https://api.deepseek.com`

**Preise:** $0,28/$0,42 pro MTok (Cache-Hit: \$0,028) — bei weitem die günstigste Frontier-Klasse-API.

**Ausgabelimits:** `deepseek-chat` maximale Ausgabe beträgt 8K Token (muss explizit über `max_tokens` gesetzt werden). `deepseek-reasoner` maximale Ausgabe beträgt 64K Token (einschließlich Chain-of-Thought).

> **V4 erwartet April 2026**: Billionen-Parameter-Multimodal-Modell mit 1M-Kontextfenster. Erwarten Sie neue Modell-IDs bei der Veröffentlichung.

```bash theme={null}
# .env — DeepSeek (budget-friendly)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.deepseek.com
LLM_MODEL=deepseek-chat
FAST_LLM_MODEL=deepseek-chat
```

```bash theme={null}
# .env — DeepSeek (with reasoning)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.deepseek.com
LLM_MODEL=deepseek-reasoner
FAST_LLM_MODEL=deepseek-chat
```

***

### Chinesische Inlandsmodelle

Alle großen chinesischen Modellanbieter stellen OpenAI-kompatible Endpunkte bereit. Diese sind besonders stark für chinesischsprachige Aufgaben und bieten wettbewerbsfähige lokale Preise.

#### Qwen / 通义千问 (Alibaba Cloud)

Qwen 3.5 (Februar 2026) ist die neueste Generation — das 397B MoE Flaggschiff übertrifft GPT-5.2 bei MMLU-Pro. Stärkste Unterstützung für chinesische Sprache und günstigste Frontier-Class-Preisgestaltung (\~\$0,11/MTok Input).

* **Base URL (China):** `https://dashscope.aliyuncs.com/compatible-mode/v1`
* **Base URL (Global):** `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`
* **Main:** `qwen3.5-plus` (Flaggschiff, 1M Kontext, $0,11/$0,66 pro MTok) oder `qwen3-max` (256K, stärkste)
* **Fast:** `qwen3.5-flash` ($0,055/$0,22 pro MTok) oder `qwen-turbo` ($0,04/$0,08 pro MTok)
* **Reasoning:** `qwen3-max` mit `enable_thinking: true` Parameter (es gibt keine separate `qwen3-max-thinking` Modell-ID)

```bash theme={null}
# .env — Qwen (China)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL=qwen3.5-plus
FAST_LLM_MODEL=qwen3.5-flash
```

```bash theme={null}
# .env — Qwen (Global)
LLM_API_KEY=sk-...
LLM_BASE_URL=https://dashscope-intl.aliyuncs.com/compatible-mode/v1
LLM_MODEL=qwen3.5-plus
FAST_LLM_MODEL=qwen3.5-flash
```

#### ChatGLM / 智谱

GLM-4.7 und GLM-5 (2026) sind die neuesten Modelle. GLM-5 ist das 745B MoE Flaggschiff, das sich Claude Opus-Niveau bei Coding-/Agent-Aufgaben nähert.

* **Basis-URL (Inland):** `https://open.bigmodel.cn/api/paas/v4`
* **Basis-URL (Z.AI International):** `https://api.z.ai/api/paas/v4`
* **Hauptmodell:** `glm-4.7` (starkes Coding, $0.60/$2.20 auf Z.AI)
* **Schnell:** `glm-4.7-flash` (kostenlos!) oder `glm-4.7-flashx` ($0.07/$0.40, höherer Durchsatz)
* **Reasoning:** `glm-5` (745B MoE Flaggschiff, $1.00/$3.20)

Erzwungenes `tool_choice` wird nicht unterstützt — nur `"auto"` funktioniert.

<Warning>
  Einige HTTP-Clients hängen automatisch `/v1` an Basis-URLs an. Zhipu verwendet `/v4` — stellen Sie sicher, dass Ihr Client keinen OpenAI-ähnlichen Pfad-Suffix erzwingt, sonst erhalten Sie 404-Fehler.
</Warning>

```bash theme={null}
# .env — ChatGLM (domestic)
LLM_API_KEY=...
LLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
LLM_MODEL=glm-4.7
FAST_LLM_MODEL=glm-4.7-flash
```

```bash theme={null}
# .env — ChatGLM (Z.AI international)
LLM_API_KEY=...
LLM_BASE_URL=https://api.z.ai/api/paas/v4
LLM_MODEL=glm-4.7
FAST_LLM_MODEL=glm-4.7-flash
```

#### MiniMax

MiniMax M2.7 (18. März 2026) ist das neueste Modell mit offenen Gewichten und erreicht 80,2% auf SWE-Bench. M2.5 bleibt als schnelle/Budget-Option verfügbar.

MiniMax bietet zwei separate API-Endpunkte für verschiedene Regionen:

* **Basis-URL (Global/海外版):** `https://api.minimax.io/v1` -- für Benutzer außerhalb des chinesischen Festlands
* **Basis-URL (China/国内版):** `https://api.minimaxi.com/v1` -- für Benutzer im chinesischen Festland (beachten Sie das zusätzliche `i` in `minimaxi`)
* **Main:** `MiniMax-M2.7`
* **Fast:** `MiniMax-M2.5`
* **Speed:** `MiniMax-M2.7-highspeed` (2x Kosten, niedrigere Latenz)

| Modell                   | Input \$/MTok | Output \$/MTok |
| ------------------------ | ------------- | -------------- |
| `MiniMax-M2.7`           | \$0.30        | \$1.20         |
| `MiniMax-M2.7-highspeed` | \$0.60        | \$2.40         |
| `MiniMax-M2.5`           | \$0.30        | \$1.20         |
| `MiniMax-M2.5-highspeed` | \$0.60        | \$2.40         |

```bash theme={null}
# .env — MiniMax (global endpoint)
LLM_API_KEY=...
LLM_BASE_URL=https://api.minimax.io/v1
LLM_MODEL=MiniMax-M2.7
FAST_LLM_MODEL=MiniMax-M2.5
```

```bash theme={null}
# .env — MiniMax (China mainland endpoint)
LLM_API_KEY=...
LLM_BASE_URL=https://api.minimaxi.com/v1
LLM_MODEL=MiniMax-M2.7
FAST_LLM_MODEL=MiniMax-M2.5
```

#### Kimi / 月之暗面 (Moonshot)

Kimi K2.5 (Januar 2026) hat 256K Kontext und starke Codierungsleistung (76,8% SWE-Bench unter Open-Source-Modellen).

* **Basis-URL (Global):** `https://api.moonshot.ai/v1`
* **Basis-URL (China):** `https://api.moonshot.cn/v1`
* **Hauptmodell:** `kimi-k2.5`
* **Schnell:** `kimi-k2` (kein Denken, Funktionsaufrufe funktionieren)
* **Reasoning:** `kimi-k2-thinking` ($0,47/$2,00 pro MTok)

Erzwungene `tool_choice` funktioniert nur, wenn der Thinking-Modus ausgeschaltet ist. Wenn Thinking aktiviert ist, wird nur `"auto"` unterstützt.

```bash theme={null}
# .env — Kimi (Global)
LLM_API_KEY=...
LLM_BASE_URL=https://api.moonshot.ai/v1
LLM_MODEL=kimi-k2.5
FAST_LLM_MODEL=kimi-k2
```

```bash theme={null}
# .env — Kimi (China)
LLM_API_KEY=...
LLM_BASE_URL=https://api.moonshot.cn/v1
LLM_MODEL=kimi-k2.5
FAST_LLM_MODEL=kimi-k2
```

***

### Lokale Modelle (Ollama)

Führen Sie Modelle vollständig auf Ihrer eigenen Hardware aus — kein API-Schlüssel erforderlich, vollständig offline. Ollama stellt standardmäßig einen OpenAI-kompatiblen Endpunkt bereit. Die Open-Source-Landschaft hat sich dramatisch verändert — Qwen 3.5, Llama 4 und GPT-OSS (OpenAIs erste Open-Weight-Modelle) sind alle verfügbar.

**Basis-URL:** `http://localhost:11434/v1`

**Empfohlene Modelle nach VRAM:**

| VRAM   | Haupt-LLM                         | Schnelles LLM | Anmerkungen                                       |
| ------ | --------------------------------- | ------------- | ------------------------------------------------- |
| 8 GB   | `qwen3.5:9b` / `gemma3:4b`        | `qwen3.5:4b`  | Qwen 3.5 9B ist das Highlight in dieser Kategorie |
| 16 GB  | `gpt-oss:20b` / `deepseek-r1:14b` | `qwen3.5:9b`  | GPT-OSS 20B ist Agent-optimiert                   |
| 24 GB  | `qwen3:32b` / `deepseek-r1:32b`   | `qwen3.5:9b`  | Qwen 3 32B ist am besten für Tool-Aufrufe         |
| 48 GB+ | `llama3.3:70b` / `gpt-oss:120b`   | `qwen3.5:14b` | Qualität nahe der Frontier                        |

**Am besten für Tool-Aufrufe:** Qwen 3/3.5 (32B+), GLM-4.7, GPT-OSS, Mistral — diese haben explizites Funktionsaufrufe-Training. Modelle mit 14B+ Parametern sind das Minimum für zuverlässige Tool-Aufrufe; 32B+ wird dringend empfohlen.

<Warning>
  **Die Qualität von Tool-Aufrufen variiert erheblich zwischen lokalen Modellen.** Nicht alle Modelle generieren zuverlässig gültige Funktionsaufrufe. Testen Sie Ihr gewähltes Modell mit Agent-Workflows, bevor Sie es in der Produktion einsetzen. Die allgemeine Regel: 14B Minimum, 32B+ empfohlen für Agent-Aufgaben.
</Warning>

```bash theme={null}
# .env — Ollama (balanced, 16GB VRAM)
LLM_API_KEY=ollama
LLM_BASE_URL=http://localhost:11434/v1
LLM_MODEL=gpt-oss:20b
FAST_LLM_MODEL=qwen3.5:9b
LLM_CONTEXT_SIZE=32768
LLM_MAX_OUTPUT_TOKENS=8192
```

```bash theme={null}
# .env — Ollama (agent-optimized, 24GB VRAM)
LLM_API_KEY=ollama
LLM_BASE_URL=http://localhost:11434/v1
LLM_MODEL=qwen3:32b
FAST_LLM_MODEL=qwen3.5:9b
LLM_CONTEXT_SIZE=32768
LLM_MAX_OUTPUT_TOKENS=8192
```

***

## Drittanbieter-Relay-Plattformen

Viele Benutzer greifen auf mehrere Modellanbieter über einen einzigen Relay-(Proxy-)Dienst zu. FIM One erkennt automatisch das richtige API-Protokoll basierend auf URL-Pfadmustern – füllen Sie einfach `LLM_BASE_URL` aus und es funktioniert.

### Funktionsweise

Wenn Ihre Basis-URL auf ein Drittanbieter-Relay verweist, inspiziert FIM One den URL-Pfad, um das zu verwendende Protokoll zu bestimmen:

| URL-Pfad enthält            | Erkanntes Protokoll | Auth-Header             | Hauptvorteil                                                        |
| --------------------------- | ------------------- | ----------------------- | ------------------------------------------------------------------- |
| `/v1` (oder kein Match)     | OpenAI-kompatibel   | `Authorization: Bearer` | Universeller Fallback, funktioniert mit den meisten Relays          |
| `/claude` oder `/anthropic` | Anthropic nativ     | `x-api-key`             | Vollständige `reasoning_content` (erweitertes Denken) Unterstützung |
| `/gemini`                   | Google nativ        | `x-goog-api-key`        | Native Gemini-Parameterübersetzung                                  |

**Auflösungsreihenfolge:** Explizites DB-Anbieterfeld > Domain-Match (offizielle APIs) > URL-Pfad-Hinweis (Relay-Plattformen) > OpenAI-kompatibler Fallback.

### Beispiel: Ein Relay, drei Protokolle

Mit einem einzelnen Relay-Konto können Sie auf verschiedene Anbieter zugreifen, indem Sie einfach den Basis-URL-Pfad ändern:

```bash theme={null}
# .env — Claude via relay (Anthropic native protocol)
LLM_API_KEY=your-relay-key
LLM_BASE_URL=https://relay.example.com/anthropic
LLM_MODEL=claude-sonnet-4-6
```

```bash theme={null}
# .env — Gemini via relay (Google native protocol)
LLM_API_KEY=your-relay-key
LLM_BASE_URL=https://relay.example.com/gemini
LLM_MODEL=gemini-2.5-pro
```

```bash theme={null}
# .env — GPT via relay (OpenAI compatible protocol)
LLM_API_KEY=your-relay-key
LLM_BASE_URL=https://relay.example.com/v1
LLM_MODEL=gpt-5.4
```

Keine zusätzliche Konfiguration erforderlich — Authentifizierungsheader, Parameterformate und Response-Parsing werden automatisch umgeschaltet.

### Schritt für Schritt: Wie die Pfaderkennung funktioniert

Hier ist ein konkretes Beispiel, das zeigt, was intern geschieht, wenn Sie ein Relay konfigurieren:

```bash theme={null}
# .env — Claude via a relay platform
LLM_API_KEY=your-relay-key
LLM_BASE_URL=https://my-relay.example.com/claude
LLM_MODEL=claude-sonnet-4-6
LLM_REASONING_EFFORT=medium
```

1. FIM One erkennt `/claude` im URL-Pfad → erkennt **Anthropic natives** Protokoll
2. Modell wird als `anthropic/claude-sonnet-4-6` für LiteLLM-Routing präfixiert
3. Anfragen verwenden das Anthropic-Format `/v1/messages` mit `x-api-key` Auth-Header
4. `reasoning_effort=medium` wird in Anthropics nativen `thinking`-Parameter übersetzt (nicht OpenAIs `reasoning_effort`)

<Warning>
  Wenn die gleiche Relay-URL stattdessen `https://my-relay.example.com/v1` wäre, würde der `/claude`-Hinweis fehlen — FIM One würde auf das OpenAI-kompatible Protokoll zurückfallen und `/v1/chat/completions`-Anfragen an einen Claude-nativen Endpunkt senden, was fehlschlagen würde. **Der URL-Pfad ist wichtig.**
</Warning>

### Warum das wichtig ist

* **Anthropic nativer Endpunkt** bietet dir ordnungsgemäße `reasoning_content`-Unterstützung (erweitertes Denken sichtbar in der UI), korrektes Tool-Calling-Format und `x-api-key`-Authentifizierung — Funktionen, die bei Verwendung der OpenAI-kompatiblen Übersetzung verloren gehen.
* **Google nativer Endpunkt** bietet dir native Gemini-Parameter und `x-goog-api-key`-Authentifizierung.
* **OpenAI kompatibel** ist der universelle Fallback und funktioniert mit jedem Relay, aber anbieterspezifische Funktionen (wie die Ausgabe des erweiterten Denkens) sind möglicherweise nicht verfügbar.

<Note>
  Wenn deine Relay-Plattform nicht standardisierte Pfadkonventionen verwendet (z. B. kein `/claude` oder `/anthropic` in der URL), greift FIM One auf das OpenAI-kompatible Protokoll zurück — das für die meisten Anwendungsfälle funktioniert. Für vollständige native Protokollunterstützung kannst du das Feld `provider` explizit über die Admin-Modellkonfiguration UI setzen.
</Note>

Relays schlagen auch auf Weise fehl, die ein direkter Anbieter nicht tut, und die meisten dieser Fehler sind stumm: ein gelöschter Parameter, ein entfernter Cache-Breakpoint, ein gepufferter Stream, der nie einen Fehler verursacht. Die Symptom-für-Symptom-Liste findest du unter [Relay/Proxy-Fallstricke](/architecture/llm-provider-guide#relayproxy-gotchas).

<Note>
  **Relays sind Best-Effort.** Das dokumentierte Verhalten von FIM One ist für First-Party-Endpunkte garantiert, d. h. OpenAI, Anthropic, Google und andere Anbieter, die ihre eigenen Modelle direkt bereitstellen. Relays funktionieren und werden häufig verwendet, auch für Modelle, die nur auf diese Weise erreichbar sind, aber was ein Relay mit einer Anfrage tut, liegt außerhalb unserer Kontrolle, daher tragen sie keine solche Garantie. Nichts wird durch Hostnamen blockiert: Die Fähigkeit wird pro Endpunkt überprüft, und nicht unterstütztes Verhalten greift von selbst zurück. Bevor du einen Fehler auf Modellebene meldest, reproduziere ihn gegen den First-Party-Endpunkt.
</Note>

## Konfigurationsstrategie

### Main vs Fast: Wann sollte man aufteilen

* **Aufteilen** wenn dein Hauptmodell teuer oder langsam ist (z. B. `gpt-5.4` + `gpt-5.4-nano`). DAG-Modus führt viele parallele Schritte aus — die Verwendung eines günstigeren schnellen Modells spart erhebliche Kosten.
* **Gleiches Modell** wenn dein Modell bereits günstig ist (z. B. `deepseek-chat` für beide). Der Overhead der Verwaltung von zwei Modellen lohnt sich nicht.

### Wann sollte man Reasoning aktivieren

* **Aktivieren** für komplexe analytische Aufgaben, mehrstufige Planung und Aufgaben, die sorgfältige Beurteilung erfordern
* **Deaktivieren** (Standard) für Routineaufgaben, einfache Fragen und Antworten sowie kostensensitive Bereitstellungen
* Reasoning erhöht typischerweise die Kosten um das 2-5-fache pro Anfrage — `medium` Aufwand ist ein guter Ausgangspunkt

### Context-Fenster-Größe

Setzen Sie `LLM_CONTEXT_SIZE` auf die tatsächliche Fenster-Größe Ihres Modells:

| Modell            | Context Window           |
| ----------------- | ------------------------ |
| GPT-5.4           | 1.050K (Aufschlag >272K) |
| o3 / o4-mini      | 200K                     |
| Claude Opus 4.6   | 1M                       |
| Claude Sonnet 4.6 | 1M                       |
| Claude Haiku 4.5  | 200K                     |
| Gemini 2.5 Pro    | 1M                       |
| Gemini 3.1 Pro    | 1M                       |
| DeepSeek V3.2     | 128K                     |
| Qwen 3.5 Plus     | 1M                       |
| Local (Ollama)    | 4K–128K (variiert)       |

Für lokale Modelle setzen Sie sowohl `LLM_CONTEXT_SIZE` als auch `LLM_MAX_OUTPUT_TOKENS` explizit — die Standardwerte gehen von Cloud-Scale-Context-Fenstern aus, die lokale Modelle nicht unterstützen können.
