🚀 Jetzt neu: FlowAI! Ein revolutionärer Chat mit personalisierten AI-Agenten. 🌟

FlowAI API - OpenAI-kompatibel

Sechs erstklassige LLMs (FlowAI, ChatGPT, Claude, Gemini, Grok, Perplexity) hinter einer einzigen, OpenAI-kompatiblen Chat-Completions-Schnittstelle. Tauschen Sie jeden bestehenden OpenAI-SDK-Aufruf gegen unsere Basis-URL und nutzen Sie Streaming, faire Limits und Trace-IDs ab Tag eins.

🚀 Schnellstart

Basis-URL: https://creativeskyline.de/api/flowai/v1/models https://creativeskyline.de/api/flowai/v1/chat/completions
Pro-Tarif erforderlich
Trial- und Free-Teams haben keinen Zugriff auf die FlowAI API. Ein aktiver Pro-Tarif fĂĽr Ihren Workspace ist Voraussetzung.

Voraussetzungen

  • Aktiver Pro-Tarif fĂĽr Ihren Workspace
  • Persönlicher API-Key mit pk_-Präfix aus Profil → API-Zugang
  • HTTP-Client mit UnterstĂĽtzung fĂĽr JSON und Server-Sent Events

Basis-URL

Alle Endpunkte hängen am gemeinsamen Versions-Prefix:

BASE_URL/api/flowai/v1

Versionierung folgt dem OpenAI-Schema. Breaking Changes erscheinen unter v2, sodass bestehende Integrationen nicht brechen.

Authentifizierung

Die FlowAI-API akzeptiert nur den Standard-OpenAI-Header Authorization: Bearer …. Token in Query-Parametern, im Body oder in alternativen Headern werden mit HTTP 401 und Code invalid_token_source abgelehnt.

Authorization: Bearer pk_dein_api_key\nAccept: application/json\nContent-Type: application/json

🤖 Modelle

Basis-URL: https://creativeskyline.de/api/flowai/v1/models https://creativeskyline.de/api/flowai/v1/chat/completions
Stabile Aliase statt Modell-IDs
Wir veröffentlichen logische Aliase in kebab-case, keine konkreten Provider-Modelle. Wenn intern auf ein neueres Modell gewechselt wird, bleibt Ihr Code unverändert.

VerfĂĽgbare Modelle abfragen

Endpoint: GET /api/flowai/v1/models

Liefert die Liste der Modell-Aliase, die fĂĽr Ihren Account freigeschaltet sind.

{\n  "object": "list",\n  "data": [\n    {"id":"flowai","object":"model","created":1735000000,"owned_by":"creativeskyline"},\n    {"id":"chatgpt","object":"model","created":1735000000,"owned_by":"creativeskyline"}\n  ],\n  "flowai_request_id": "01HXYZ…ULID"\n}

VerfĂĽgbare Aliase

  • flowai - Allrounder: kombiniert die besten Modelle fĂĽr jede Aufgabe
  • chatgpt - Kreativ: Brainstorming, Texte, E-Mails, Copywriting
  • claude - Analytisch: lange Dokumente, präzise Anweisungen, Nuancen
  • gemini - Technisch: Datenanalyse, Kalkulationen, multimodal
  • grok - Schnell: prägnante Antworten, Faktencheck, Quick-Lookups
  • perplexity - Recherche: aktuelle Web-Quellen, fundierte Recherche-Antworten

đź’¬ Chat-Completions

Basis-URL: https://creativeskyline.de/api/flowai/v1/models https://creativeskyline.de/api/flowai/v1/chat/completions
Vollständig zustandslos
Der Endpunkt ist vollständig zustandslos - bei jeder Anfrage muss der gesamte Nachrichtenverlauf mitgegeben werden. Die FlowAI-API speichert keine Threads, Messages oder Vektor-Embeddings.
Nicht unterstĂĽtzte Felder
Folgende Felder werden mit HTTP 400 und Code unsupported_field abgelehnt: response_format, audio, n, logprobs, top_logprobs, tools, tool_choice, Bild-/Datei-Content-Blöcke.

UnterstĂĽtzte Parameter

Pflichtfelder

  • model - einer der sechs Aliase (string, kebab-case)
  • messages[] - 1 bis 50 Einträge mit role (system/user/assistant/tool) und content

Optional (OpenAI-Passthrough)

  • stream - Boolean (Standard: false)
  • temperature - 0 bis 2
  • max_tokens - 1 bis 128.000
  • top_p, frequency_penalty, presence_penalty, stop, seed, user

Chat-Completion (Non-Streaming)

POST /api/flowai/v1/chat/completions

Sendet eine Konversation und erhält eine vollständige JSON-Antwort. Standardverhalten ohne stream oder mit stream: false. Body-Limit: 128 KB, max. 50 Nachrichten, max. 32.000 Zeichen pro Nachricht.

Request Body:

model string * Modell-Alias: flowai, chatgpt, claude, gemini, grok oder perplexity
messages array * 1 bis 50 Nachrichten mit role (system/user/assistant) und content
stream boolean false (Standard) für vollständige JSON-Antwort
temperature number Kreativität 0 bis 2
max_tokens integer 1 bis 128.000

Beispiel-Response:

{"id":"chatcmpl_01HXYZ…ULID","object":"chat.completion","created":1735000000,"model":"claude","choices":[{"index":0,"message":{"role":"assistant","content":"Das Reinheitsgebot von 1516 erlaubt für Bier nur …"},"finish_reason":"stop"}],"usage":{"prompt_tokens":42,"completion_tokens":87,"total_tokens":129},"flowai_request_id":"01HXYZ…ULID"}

Chat-Completion (Streaming / SSE)

POST /api/flowai/v1/chat/completions SSE / Streaming SSE

Sendet eine Konversation und empfängt die Antwort Token für Token via Server-Sent Events. Setzen Sie "stream": true im Body. Antwort kommt mit Content-Type: text/event-stream; Proxy-Buffering ist über X-Accel-Buffering: no deaktiviert.

Request Body:

model string * Modell-Alias: flowai, chatgpt, claude, gemini, grok oder perplexity
messages array * 1 bis 50 Nachrichten mit role und content
stream boolean * true - aktiviert den SSE-Streaming-Modus

Beispiel-Response:

data: {"id":"chatcmpl_01HXYZ…","object":"chat.completion.chunk","created":1735000000,"model":"claude","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl_01HXYZ…","object":"chat.completion.chunk","created":1735000000,"model":"claude","choices":[{"index":0,"delta":{"content":"Das "},"finish_reason":null}]}

data: {"id":"chatcmpl_01HXYZ…","object":"chat.completion.chunk","created":1735000000,"model":"claude","choices":[{"index":0,"delta":{"content":"Reinheitsgebot "},"finish_reason":null}]}

data: {"id":"chatcmpl_01HXYZ…","object":"chat.completion.chunk","created":1735000000,"model":"claude","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":42,"completion_tokens":87,"total_tokens":129}}

data: [DONE]

📦 Limits & Rate-Limit

Basis-URL: https://creativeskyline.de/api/flowai/v1/models https://creativeskyline.de/api/flowai/v1/chat/completions

Body-Limits

  • 128 KB Request-Body insgesamt
  • Bis zu 50 Nachrichten pro Request
  • Maximal 32.000 Zeichen Content pro Nachricht

Übergrößen werden mit HTTP 413 und Code payload_too_large abgelehnt.

Rate-Limit

  • 60 Requests/Minute dauerhaft
  • 5 Requests/Sekunde Burst
  • SchlĂĽssel: API-Token (jeder Token hat ein eigenes Budget)

Antworten enthalten OpenAI-kompatible Header: x-ratelimit-limit-requests, x-ratelimit-remaining-requests, x-ratelimit-reset-requests.

⚠️ Fehlerbehandlung

Basis-URL: https://creativeskyline.de/api/flowai/v1/models https://creativeskyline.de/api/flowai/v1/chat/completions

Einheitliches Fehler-Format

Alle Fehlerantworten haben dieselbe OpenAI-kompatible Struktur. Das Top-Level-Feld flowai_request_id ist immer enthalten.

{\n  "error": {\n    "message": "Authorization: Bearer header is required on the FlowAI API.",\n    "type": "authentication_error",\n    "code": "invalid_token_source",\n    "param": null\n  },\n  "flowai_request_id": "01HXYZ…ULID"\n}

Häufige Fehlercodes

  • 400 invalid_field_value - Validierung fehlgeschlagen (Typ, Bereich, Pflichtfeld)
  • 400 unsupported_field - Feld noch nicht unterstĂĽtzt (z.B. tools, response_format)
  • 401 invalid_token_source - Token nicht via Authorization: Bearer ĂĽbergeben
  • 401 invalid_api_key - Token unbekannt, abgelaufen oder widerrufen
  • 401 no_active_subscription - Workspace hat keinen aktiven Pro-Tarif
  • 404 model_not_found - Unbekannter Alias (gĂĽltige Aliase siehe /v1/models)
  • 413 payload_too_large - Request-Body ĂĽber 128 KB
  • 429 rate_limit_exceeded - 60/min oder 5/sec ĂĽberschritten
  • 502 provider_unavailable - Upstream-Provider nicht erreichbar