Flatkey API direkt aufrufen

Basis-URL: https://router.flatkey.ai Flatkey stellt eine OpenAI-kompatible REST API bereit. Wenn du bereits einen HTTP-Client hast, benötigst du kein SDK. Diese Seite ist der kürzeste Weg von einem Schlüssel zu einer funktionierenden Anfrage.

Authentifizieren

Jede Anfrage trägt deinen Schlüssel als Bearer-Token:

Authorization: Bearer YOUR_FLATKEY_API_KEY

Erstelle einen Schlüssel in der Konsole. Schlüssel beginnen mit sk-fk-. Speichere ihn in einer Umgebungsvariable und halte ihn aus dem Quellcode und Browser-Code heraus.

export FLATKEY_API_KEY="sk-fk-..."

Eine Anfrage senden

curl --fail-with-body -sS https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Ein erfolgreicher Aufruf gibt das Standard-Chat-Completion-Objekt mit choices und usage zurück.

Verfügbare Endpunkte

Endpunkt	Zweck
`POST /v1/chat/completions`	Text- und Chat-Generierung
`POST /v1/responses`	Responses API, für OpenAI-Modelle
`POST /v1/images/generations`	Bildgenerierung und -bearbeitung
`POST /v1/videos`	Videogenerierung, asynchron
`GET /v1/videos/{task_id}`	Einen Video-Task abfragen
`GET /v1/models`	Verfügbare Modelle auflisten
`GET /v1/credits`	Verbleibendes Guthaben

POST /v1/responses funktioniert derzeit mit OpenAI-Modellen. Andere Modellfamilien geben bei diesem Endpunkt einen Fehler zurück — verwende für diese POST /v1/chat/completions.

Guthaben prüfen

curl --fail-with-body -sS https://router.flatkey.ai/v1/credits \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

{ "remaining": 34.18, "used": 185.13 }

Fehler behandeln

Fehler geben einen JSON-Body mit einer aussagekräftigen Meldung zurück:

{ "error": { "message": "No available channel for model ..." } }

Status	Bedeutung	Was zu tun ist
`400`	Fehlerhafte Anfrage	Lies die Meldung; sie nennt das fehlerhafte Feld
`401`	Ungültiger Schlüssel	Prüfe den `Authorization`-Header und den Schlüsselwert
`429`	Zu viele Anfragen	Warte und versuche es erneut
`500`, `503`	Modell oder Route nicht verfügbar	Wechsle das Modell. Ein erneuter Versuch mit demselben Modell behebt das Problem selten

Vollständige Liste in der Fehlerreferenz.

Nächste Schritte

API-Referenz

Jeder Endpunkt, Parameter und Antwortfeld.

Stattdessen ein SDK verwenden

Behalte deinen OpenAI- oder Anthropic-Client und ändere eine einzige Zeile.

Schnellstart

Code

Gängige KI-Tools

Medienerzeugung

Beliebte Modelle

Dashboard

Referenz

Flatkey API direkt aufrufen

Authentifizieren

Eine Anfrage senden

Verfügbare Endpunkte

Guthaben prüfen

Fehler behandeln

Nächste Schritte

API-Referenz

Stattdessen ein SDK verwenden

​Authentifizieren

​Eine Anfrage senden

​Verfügbare Endpunkte

​Guthaben prüfen

​Fehler behandeln

​Nächste Schritte

API-Referenz

Stattdessen ein SDK verwenden

Authentifizieren

Eine Anfrage senden

Verfügbare Endpunkte

Guthaben prüfen

Fehler behandeln

Nächste Schritte