Zum Hauptinhalt springen
Mit veröffentlichten Spaces stellen Administratoren konfigurierte als eigenständige HTTP-Chat-Endpunkte bereit. Externe Anwendungen, Kundenportale, interne Bots oder automatisierte Workflows können mehrstufige Unterhaltungen an einen veröffentlichten Space senden und erhalten Antworten auf Basis der Space Instruktionen, des gewählten Modells und des hinterlegten Space-Wissens.
Bevor Sie diesen Endpunkt aufrufen können, muss ein Administrator den Space unter Team-Einstellungen > Veröffentlichte Spaces freigeben und die eindeutige Endpunkt-URL kopieren. Mehr dazu unter Veröffentlichte Spaces.
Sicherheitshinweis zu Endpunkt-URL & Datenschutz:
  • Authentifizierung über {endpointId}: POST /v1/endpoints/{endpointId}/chat prüft keinen X-API-Key. Allein die Kenntnis der {endpointId}-UUID berechtigt zum Aufruf des veröffentlichten Space. Halten Sie die Endpunkt-URL auf Ihrem Server geheim und betten Sie sie niemals in öffentlichen Frontend-Code ein.
  • Privacy Filter deaktiviert: Der Omnifact Privacy Filter ist auf Endpunkten veröffentlichter Spaces deaktiviert, damit angebundene Systeme unveränderte Modellantworten erhalten.

Endpunkt

POST /v1/endpoints/{endpointId}/chat

Pfadparameter

Anfrage-Header

Anfrage-Body (application/json)

Regeln für die Nachrichtenreihenfolge

Die API validiert den Nachrichtenverlauf bei jeder Anfrage strikt:
  1. messages muss mindestens eine Nachricht enthalten, und jeder content-String darf nicht leer sein.
  2. Es sind ausschließlich die Rollen "user" und "assistant" zulässig ("system" wird abgelehnt; Systemvorgaben hinterlegen Sie in den Space Instruktionen des Space).
  3. Sowohl die erste als auch die letzte Nachricht in messages muss role: "user" besitzen.
  4. Die Rollen müssen sich strikt abwechseln (user → assistant → user). Aufeinanderfolgende Nachrichten derselben Rolle führen zu 400 (unexpected_message_order).

Antwortformate

1. Standard-JSON-Antwort (streaming: false)

Bei streaming: false gibt der Endpunkt nach Abschluss der Generierung ein JSON-Objekt mit id, content, tokenUsage sowie entweder references (Standard) oder sources (bei omnifact-enable-inline-sources: true) zurück.

Beispielanfrage

JSON-Antwort (200 OK)


2. SSE-Streaming-Antwort (streaming: true)

Bei streaming: true streamt der Endpunkt Server-Sent Events (Content-Type: text/event-stream).

SSE-Ereignistypen

Beispiel einer Streaming-Anfrage

Beispiel für den SSE-Stream


Fehlercodes & Modellkompatibilität

Hinweis zur Modellkompatibilität: Modelle, die Funktionsaufrufe ausschließlich über die OpenAI Responses API unterstützen, konkret GPT-6.1 Sol (OpenAI und Azure OpenAI), stehen für veröffentlichte Spaces nicht zur Verfügung (invalid_endpoint_setup). Nutzen Sie Modelle wie GPT-6.1 Terra, Claude Sonnet 5.5, Gemini 4 Argon oder Mistral Large 4.

Codebeispiele

Nächste Schritte