App öffnen
Moonborn — Developers

OpenAI-kompatibel

Ein drop-in-kompatibler chat/completions-Endpunkt — Base-URL ändern, API-Schlüssel tauschen, das Model-Feld auf eine Persona-ID setzen. Streaming, Tool Calling und Function Calling laufen unverändert hindurch.

Drop-in-Kompatibilität

Wenn du bereits das OpenAI-SDK verwendest (oder einen Wrapper, der die OpenAI-Form spricht), ist Moonborn nur einen Base-URL-Wechsel entfernt. Der Endpunkt unter https://api.moonborn.co/v1/openai akzeptiert Requests in OpenAI-Form und gibt Antworten in OpenAI-Form zurück — mit dem model-Feld, das eine Persona-ID statt gpt-4 trägt.

import OpenAI from 'openai';
 
const client = new OpenAI({
 apiKey: process.env.MOONBORN_API_KEY,
 baseURL: 'https://api.moonborn.co/v1/openai',
});
 
const response = await client.chat.completions.create({
 model: 'persona://persona_mert_abc123',
 messages: [{ role: 'user', content: 'What drives you?' }],
});

Dieselbe Aufrufform in Python mit dem OpenAI-Python-SDK, dieselbe Aufrufform mit curl. Keine neue Client-Bibliothek nötig.

Unterstützt

  • POST /v1/openai/chat/completions — Streaming und Non-Streaming.
  • GET /v1/openai/models — listet deine Workspace-Personas als Modelle.
  • Tool Calling und Function Calling — werden zum persona-gebundenen Chat-Runtime durchgereicht.

Wichtige Unterschiede

Die Form ist OpenAI-kompatibel; das Verhalten ist Moonborn:

  • model ist eine Persona-Referenz (persona://<id>), kein generisches Modell.
  • Antwort-Metadaten — drift-Score, Schichtzuordnung, audit-ID — werden über x-moonborn-*-Response-Header geliefert. OpenAI-Clients ignorieren sie sicher; falls du sie parsen willst, sind sie verfügbar.
  • Rate-Limit- und Token-Count-Header folgen den OpenAI-Konventionen, die zugrundeliegenden Limits stammen aber aus deinem Moonborn-Workspace-Tarif (siehe Tarife).
  • Die drift-Detection-Regeln der Persona gelten weiterhin. Wenn eine Antwort die Workspace-Schwelle überschreitet, trägt die Response x-moonborn-drift-alert: true und wird (falls konfiguriert) vor der Auslieferung durch die Fallback-Recovery geleitet.

Migrations-Checkliste

  1. Tausche OPENAI_API_KEY gegen MOONBORN_API_KEY.
  2. Setze die Base-URL auf https://api.moonborn.co/v1/openai.
  3. Ersetze Modell-IDs durch Persona-IDs (persona://<id>).
  4. Teste in einem Sandbox-Workspace mit sk_test_*-Schlüsseln.
  5. Schalte die Produktion um.

Was nicht kompatibel ist

  • Bildgenerierung.
  • Embeddings.
  • Audio (TTS / STT).

Das ist nicht Moonborns Domäne. Behalte deinen OpenAI-Client für diese Endpunkte parallel; nutze Moonborn für die persona-gebundene Chat-Schicht.

Tarif

Free und höher. Der Endpunkt erbt das Rate Limit deines Workspace-Plans — siehe Tarife.

Weiter