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

# Dify

> Integrieren Sie TokenLab mit Dify unter Verwendung des OpenAI-Providers und einer benutzerdefinierten Basis-URL

## Überblick

Dify funktioniert gut mit TokenLab über den OpenAI-kompatiblen Modell-Provider-Flow.

Dies ist ein auf Chat-Completions ausgerichteter Integrationspfad. Dies sollte nicht als Garantie dafür verstanden werden, dass Dify dieselben Responses oder dasselbe WebSocket-Verhalten wie dedizierte Codex-Integrationen bereitstellt.

Für aktuelle Dify-Versionen ist der sicherste Weg in der Regel:

* Wählen Sie den integrierten **OpenAI**-Provider
* Geben Sie Ihren TokenLab API-Key ein
* Legen Sie eine benutzerdefinierte Basis-URL von `https://api.tokenlab.sh/v1` fest

<Note>
  Einige ältere Dify-Builds stellen dies als `OpenAI-API-compatible` anstelle des integrierten `OpenAI`-Providers mit einem Feld für eine benutzerdefinierte Basis-URL dar. Wenn Ihre Dify-Benutzeroberfläche anders aussieht, verwenden Sie den am besten geeigneten OpenAI-kompatiblen benutzerdefinierten Provider-Flow, der in dieser Version verfügbar ist.
</Note>

<Note>
  **Typ**: Framework oder Plattform

  **Primärer Pfad**: OpenAI-kompatibler Chat-Pfad

  **Support-Vertrauen**: Unterstützt mit Einschränkungen im Umfang
</Note>

## Voraussetzungen

* TokenLab-Konto mit API-Zugriff
* Dify Cloud oder selbst gehostetes Dify

## Konfigurationsschritte

### Schritt 1: API-Key abrufen

1. Melden Sie sich im [TokenLab Dashboard](https://tokenlab.sh/dashboard) an
2. Öffnen Sie [API Keys](https://tokenlab.sh/dashboard/api)
3. Erstellen oder kopieren Sie einen API-Key, der mit `sk-` beginnt

### Schritt 2: Provider konfigurieren

<Steps>
  <Step title="Modell-Provider öffnen">
    Gehen Sie in Dify zu **Settings** → **Model Providers**
  </Step>

  <Step title="OpenAI auswählen">
    Öffnen Sie die Einstellungen des **OpenAI**-Providers. Wenn Ihre Dify-Version hier keine benutzerdefinierte Basis-URL anbietet, verwenden Sie stattdessen die in dieser Version verfügbare OpenAI-kompatible benutzerdefinierte Provider-Option.
  </Step>

  <Step title="TokenLab-Einstellungen eingeben">
    Verwenden Sie diese Werte:

    | Feld                           | Wert                         |
    | ------------------------------ | ---------------------------- |
    | API Key                        | `sk-your-tokenlab-key`       |
    | API Base URL / Custom Base URL | `https://api.tokenlab.sh/v1` |
  </Step>

  <Step title="Modelle hinzufügen">
    Fügen Sie die Modelle hinzu, die Sie verwenden möchten, zum Beispiel:

    * `gpt-5.4`
    * `gpt-5.4-mini`
    * `claude-sonnet-5`
    * `claude-opus-4-8`
    * `gemini-3.5-flash`
    * `gemini-3.1-flash-lite`
    * `deepseek-v4-flash`
  </Step>
</Steps>

### Schritt 3: Verbindung testen

1. Wählen Sie ein Modell wie `gpt-5-mini` oder `gpt-4o`
2. Senden Sie einen Test-Prompt
3. Bestätigen Sie, dass Dify eine gültige Antwort erhält

## Embeddings für Knowledge Bases

Für RAG und Knowledge-Base-Indizierung fügen Sie ein Embedding-Modell hinzu, wie zum Beispiel:

* `text-embedding-3-small`
* `text-embedding-3-large`

Legen Sie es dann als Standard-Embedding-Modell in den entsprechenden Knowledge-Base- oder Anwendungseinstellungen fest.

## Empfohlene Modellrollen

| Anwendungsfall        | Empfohlene Modelle                                         |
| --------------------- | ---------------------------------------------------------- |
| Standard-Chat         | `gpt-5.4-mini`, `gpt-5.4`, `claude-sonnet-5`               |
| Tiefes Schlussfolgern | `gpt-5.5`, `gpt-5.4`, `claude-opus-4-8`, `deepseek-v4-pro` |
| Schnell/Günstig       | `gpt-5.4-mini`, `gemini-3.5-flash`, `deepseek-v4-flash`    |
| Embeddings            | `text-embedding-3-small`, `text-embedding-3-large`         |

## Best Practices

<AccordionGroup>
  <Accordion title="Mit dem integrierten OpenAI-Provider starten">
    In neueren Dify-Versionen ist der integrierte OpenAI-Provider mit einer benutzerdefinierten Basis-URL normalerweise das sauberste Setup für TokenLab.
  </Accordion>

  <Accordion title="Günstigere Modelle für Iterationen verwenden">
    Verwenden Sie `gpt-5.4-mini`, `gemini-3.5-flash` oder `deepseek-v4-flash` während der Iteration und wechseln Sie bei schwereren Workflows nur dort zu stärkeren Modellen, wo dies erforderlich ist.
  </Accordion>

  <Accordion title="Dify ist in der Regel auf Chat-Completions ausgerichtet">
    Die meisten Dify-Flows verwenden OpenAI-kompatibles Chat-Verhalten. Wenn Sie Codex-spezifische Responses oder WebSocket-Verhalten benötigen, verwenden Sie stattdessen die dedizierten Codex-Integrationen.
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Verbindungsfehler">
    * Überprüfen Sie, ob die Basis-URL exakt `https://api.tokenlab.sh/v1` lautet
    * Entfernen Sie nachgestellte Schrägstriche, falls Dify diese dupliziert
    * Bestätigen Sie, dass der Dify-Server TokenLab über das öffentliche Internet erreichen kann
  </Accordion>

  <Accordion title="401 Unauthorized">
    * Überprüfen Sie den API-Key erneut
    * Bestätigen Sie, dass der Key im TokenLab-Dashboard aktiv ist
    * Stellen Sie sicher, dass der in Dify eingefügte Wert keine zusätzlichen Leerzeichen oder Zeilenumbrüche enthält
  </Accordion>

  <Accordion title="Modell nicht gefunden">
    * Überprüfen Sie den Modellnamen exakt
    * Fügen Sie den Modelleintrag erneut hinzu, falls die Provider-UI einen älteren Wert zwischengespeichert hat
    * Überprüfen Sie die aktuelle Modellverfügbarkeit in der TokenLab-Dokumentation oder im Dashboard
  </Accordion>
</AccordionGroup>