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

# Schnellstart: Wähle, wie du Flatkey nutzen willst

> Vier Wege, Flatkey zu nutzen — die REST API, das OpenAI SDK, die Flatkey CLI oder deinen Coding-Agenten. Ein Schlüssel und ein Modellkatalog hinter allen vieren.

Flatkey gibt dir einen Schlüssel und vier Wege, ihn einzusetzen. Alle vier teilen sich denselben Account, dasselbe Guthaben und denselben Modellkatalog — die einzige Frage ist, welcher zu deiner Arbeitsweise passt.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/console-choose-how.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=99ada27fab6ab988299090f74cd627c0" alt="Die vier Wege, Flatkey zu nutzen, dargestellt in der Flatkey Console" width="3000" height="852" data-path="images/quickstart/console-choose-how.png" />
</Frame>

<Tip>
  Du musst dich nicht ein für alle Mal entscheiden. Beginne mit dem, was deiner aktuellen Arbeit am nächsten kommt, und ergänze die anderen später mit demselben Schlüssel.
</Tip>

## Bevor du startest

Erstelle einen Schlüssel unter [console.flatkey.ai/keys](https://console.flatkey.ai/keys). Flatkey-Schlüssel beginnen mit `sk-`. Jede der folgenden Optionen verwendet diesen einen Schlüssel — bewahre ihn also in einer Umgebungsvariable auf und halte ihn aus der Versionskontrolle heraus.

Jedes Panel in der Console erlaubt dir außerdem, statt einen neuen Schlüssel zu erstellen, einen vorhandenen auszuwählen, der dann direkt in das angezeigte Snippet eingesetzt wird.

## API für Entwickler

Rufe jedes Modell über einfaches HTTP mit einer OpenAI-kompatiblen Anfrage auf. Kein SDK, keine Abhängigkeiten — wenn du einen HTTP-Client hast, kannst du direkt loslegen.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-api.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=3dd0485d2730b29d52b3285bdbe176b7" alt="Das Panel „API für Entwickler“ mit einer sofort ausführbaren Anfrage" width="1540" height="1150" data-path="images/quickstart/modal-api.png" />
</Frame>

Die Console erstellt die Anfrage für dich: wähle einen Schlüssel, wähle ein Modell und kopiere das Snippet in **cURL**, **Node.js** oder **Python**.

```bash theme={"dark"}
curl https://router.flatkey.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Say hello in one sentence."}]}'
```

<Card title="API-Zugang" icon="code" href="/de/guides/api-access">
  Basis-URL, Authentifizierung, verfügbare Endpunkte und Fehlerbehandlung.
</Card>

## SDKs für Entwickler

Behalte das OpenAI SDK, das du bereits verwendest, und richte es auf Flatkey aus. Dein Anfrage-Code ändert sich nicht — nur die Basis-URL.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-sdk.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=255f7df4814995aa07fb1816ad7342d1" alt="Das Panel „SDKs für Entwickler“ mit dem SDK-Setup" width="1540" height="1150" data-path="images/quickstart/modal-sdk.png" />
</Frame>

Gleiches Prinzip wie oben: wähle einen Schlüssel und ein Modell, dann kopiere das Setup für deine Sprache.

```python theme={"dark"}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)
```

<CardGroup cols={2}>
  <Card title="OpenAI SDK" icon="code" href="/de/guides/openai-sdk">
    Setup für Python und Node.js, Streaming und Tool Calling.
  </Card>

  <Card title="Anthropic SDK" icon="code" href="/de/guides/anthropic-sdk">
    Leite Claude-Anfragen auf die gleiche Weise über Flatkey.
  </Card>
</CardGroup>

## Flatkey CLI

Erzeuge Bilder und Videos direkt aus deinem Terminal, oder lass einen KI-Assistenten die CLI für dich steuern.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-cli.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=a31f30bab8e5eecfc1f84fe593749af1" alt="Das Panel „Flatkey CLI“ mit Installation, Anmeldung und erstem Prompt" width="1540" height="930" data-path="images/quickstart/modal-cli.png" />
</Frame>

<Steps>
  <Step title="Installieren">
    ```bash theme={"dark"}
    npm i -g @flatkey-ai/cli
    ```
  </Step>

  <Step title="Anmelden">
    ```bash theme={"dark"}
    flatkey login
    ```
  </Step>

  <Step title="Loslegen">
    Sag deinem KI-Assistenten, was du möchtest, und lass ihn die CLI ausführen:

    ```text theme={"dark"}
    Use Flatkey CLI to generate a "beautiful sunrise" picture.
    ```
  </Step>
</Steps>

<Card title="Flatkey CLI mit KI-Agent" icon="terminal" href="/de/guides/flatkey-cli">
  Befehle, JSON-Ausgabe für Agenten und Fehlerbehebung.
</Card>

## Codex & Claude Code

Verbinde deinen Coding-Agenten einmal und nutze Flatkey anschließend aus den Projekten, die du bereits geöffnet hast.

<Frame>
  <img src="https://mintcdn.com/flatkey/9eYACi20Ep-B6T7F/images/quickstart/modal-agents.png?fit=max&auto=format&n=9eYACi20Ep-B6T7F&q=85&s=0fadd534691bdc978983917445268b6f" alt="Das Panel „Codex und Claude Code“ mit dem Installationsbefehl" width="1540" height="1064" data-path="images/quickstart/modal-agents.png" />
</Frame>

Die Console gibt dir einen einzigen Installationsbefehl für **macOS**, **Linux** oder **Windows**. Er installiert den Agenten, falls du ihn noch nicht hast, fragt nach deinem Schlüssel und schreibt die Konfiguration für dich.

<Warning>
  Der Installer ist interaktiv. Er fragt, ob du Claude Code oder Codex CLI möchtest, und benötigt bereits installiertes Node.js.
</Warning>

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/de/guides/claude-code">
    Manuelles Setup oder CC Switch.
  </Card>

  <Card title="Codex CLI" icon="code" href="/de/guides/codex-cli">
    Leite Codex CLI über Flatkey.
  </Card>

  <Card title="Codex Desktop" icon="desktop" href="/de/guides/codex-desktop">
    Konfiguriere die Desktop-App.
  </Card>
</CardGroup>

## Überprüfe, ob es funktioniert hat

Egal, für welche Option du dich entschieden hast — öffne nach deiner ersten Anfrage **Usage Logs** in der [Console](https://console.flatkey.ai). Du solltest sie dort mit Modell, Token-Anzahl, Latenz und Kosten aufgelistet sehen.

<img src="https://mintcdn.com/flatkey/ln614ti05NsEoN0h/images/quickstart/flatkey-usage-logs.png?fit=max&auto=format&n=ln614ti05NsEoN0h&q=85&s=90a23fb955d4a547c179087b73ab59df" alt="Verwende den Filter „Model Name“ in den Flatkey Usage Logs" width="1600" height="840" data-path="images/quickstart/flatkey-usage-logs.png" />

Falls nichts erscheint, warte ein paar Sekunden und suche erneut, und überprüfe dann den API-Schlüssel und die Basis-URL, die die Anfrage tatsächlich verwendet hat.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Modellverzeichnis" icon="list" href="https://flatkey.ai/models">
    Jedes unterstützte Modell mit aktuellen Preisen und Verfügbarkeit.
  </Card>

  <Card title="API-Fehler" icon="triangle-exclamation" href="/de/api-reference/errors">
    Statuscodes, Antwortformate und was dagegen zu tun ist.
  </Card>

  <Card title="Textgenerierung" icon="message" href="/de/guides/text-generation">
    Streaming, Tool Calling und strukturierte Ausgabe.
  </Card>

  <Card title="Videogenerierung" icon="video" href="/de/guides/video-generation">
    Erstelle eine Aufgabe, frage sie ab und lade die MP4 herunter.
  </Card>
</CardGroup>
