Zum Hauptinhalt springen

Was ist das API Gateway?

Das Omnifact API Gateway bietet eine einheitliche API, um über einen einzigen Endpunkt auf Modelle führender KI-Anbieter zuzugreifen. Es ermöglicht Ihren Entwicklern und internen Anwendungen, Anfragen direkt an leistungsstarke KI-Modelle weiterzuleiten, ohne dass Sie separate Konten bei verschiedenen KI-Anbietern einrichten müssen. Zu den wichtigsten Vorteilen gehören:
  • Ein Schlüssel, mehrere Anbieter: Greifen Sie mit einem einzigen API-Schlüssel auf Modelle von OpenAI, Anthropic, Google, Mistral AI und Weiteren zu.
  • Nahtloser Austausch: Wechseln Sie mit minimalen Codeänderungen zwischen Anbietern und Modellen, indem Sie bestehende OpenAI-kompatible SDKs verwenden.
  • Zentrale Abrechnung & Übersicht: Überwachen Sie Ihre Ausgaben und Nutzung über alle Anbieter hinweg an einem Ort. Sie benötigen keine Kreditkarten für separate Anbieter.
  • Nutzung Ihres bestehenden Budgets: Der Verbrauch wird über das bestehende KI-Budget Ihrer Organisation abgerechnet und läuft über Ihren Omnifact-Vertrag.

Erste Schritte

Das API Gateway steht exklusiv Kunden im Enterprise-Plan zur Verfügung. Besuchen Sie unsere Abrechnung-Seite oder kontaktieren Sie den Support, um ein Upgrade durchzuführen.
Um das API Gateway zu nutzen, müssen Sie den API-Zugriff aktivieren und einen API-Schlüssel generieren.
  1. Voraussetzungen: Stellen Sie sicher, dass der Zugriff auf das API Gateway für Ihre Organisation durch Omnifact aktiviert wurde. (Hinweis: Wenn diese Funktion für Ihre Organisation nicht aktiviert ist, geben alle Anfragen an die API den Fehler 403 Forbidden zurück.)
  2. Aktivierung: Ein Administrator muss das Gateway im Bereich Entwicklertools aktivieren.
  3. Authentifizierung: Alle Anfragen an das API Gateway müssen Ihren API-Schlüssel (den Sie unter Team-Einstellungen > Entwicklertools generieren können) im X-API-Key-Header (oder als Bearer-Token bei Verwendung von OpenAI-SDKs) enthalten.

Verfügbare Modelle

Sie können die verfügbaren Modelle über den standardmäßigen OpenAI-Modell-Endpunkt abfragen. Detaillierte Spezifikationen zu den Endpunkt-Parametern und Antwortformaten finden Sie in der OpenAI API-Referenz.

GET /gateway/v1/models

curl https://api.omnifact.ai/gateway/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Beispielantwort:
{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715368132,
      "owned_by": "openai"
    },
    {
      "id": "claude-4-sonnet",
      "object": "model",
      "created": 1718841600,
      "owned_by": "anthropic"
    }
  ]
}

Chat Completions

Das API Gateway bietet nahtlos kompatible APIs, mit denen Sie Anbieter wechseln können, indem Sie einfach Ihre Basis-URL in https://api.omnifact.ai/gateway/v1 ändern. Es sind keine Code-Umschreibungen erforderlich. Sie können dieselben SDKs und Tools verwenden, die Sie bereits kennen.

POST /gateway/v1/chat/completions

Dieser Endpunkt akzeptiert das standardmäßige OpenAI-kompatible Format und unterstützt Streaming, Routing, benutzerdefinierte Temperaturen und mehr. (Hinweis: Tool Calling und Structured Outputs werden in V1 nicht unterstützt).
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.omnifact.ai/gateway/v1',
  apiKey: 'YOUR_API_KEY', // typically process.env.OMNIFACT_API_KEY
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hello, how are you?' }],
    stream: true,
  });

  for await (const chunk of response) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

main();

Nutzung & Abrechnung

Die Nutzung des API Gateways verbraucht das monatliche KI-Budget Ihrer Organisation. Das bedeutet, dass Sie keine separate Abrechnung für die API-Nutzung verwalten müssen. Bitte beachten Sie, dass die Nutzung des API Gateways einen Aufschlag auf die Basis-Modellkosten beinhaltet.
Strikte Durchsetzung des Guthabens: Im Gegensatz zur Chat-Benutzeroberfläche (die auf Basis-Modelle zurückgreift, wenn das Guthaben aufgebraucht ist) setzt das API Gateway die Guthabenlimits strikt durch. Wenn das Guthaben Ihrer Organisation aufgebraucht ist, werden alle API-Anfragen blockiert, bis neues Guthaben hinzugefügt wird oder der Abrechnungszyklus zurückgesetzt wird. Basis-Modelle sind vom API-Zugriff vollständig ausgeschlossen.
Sie können Ihre gesamte Nutzung und den Guthabenverbrauch im Dashboard Abrechnung & Nutzung überwachen.

FAQ

Noch nicht. Die Integration des Privacy Filters für das API Gateway ist für ein zukünftiges Update geplant.
Die verfügbaren Modelle hängen vom spezifischen Omnifact-Plan und der Konfiguration Ihrer Organisation ab. Sie können den Endpunkt /gateway/v1/models verwenden, um die genaue Liste der für Sie verfügbaren Modelle einzusehen. Bitte beachten Sie, dass Basis-Modelle vom API-Zugriff ausgeschlossen sind.
Derzeit gibt es nur einen API-Schlüssel pro Organisation, der über den Bereich Entwicklertools verwaltet wird.