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.
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:messagesmuss mindestens eine Nachricht enthalten, und jedercontent-String darf nicht leer sein.- Es sind ausschließlich die Rollen
"user"und"assistant"zulässig ("system"wird abgelehnt; Systemvorgaben hinterlegen Sie in den Space Instruktionen des Space). - Sowohl die erste als auch die letzte Nachricht in
messagesmussrole: "user"besitzen. - Die Rollen müssen sich strikt abwechseln (
user→assistant→user). Aufeinanderfolgende Nachrichten derselben Rolle führen zu400(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.
- Standard (references)
- Inline-Quellen (omnifact-enable-inline-sources: true)
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
- JavaScript / Node.js
- Python
Nächste Schritte
- Automatisieren Sie Dokument-Uploads mit der Dokumente-API
- Verwalten Sie Modelle, Abschaltungswarnungen und Endpunkte unter Veröffentlichte Spaces