SYNDERESIS / API PFLEGEN
Gehostete Kunden-API · Vertrag überprüft am 7. November 2026
Migration und FAQs
Auf dieser Seite
- Migration und FAQs
- Migrationscheckliste
- Ältere Synderesis-Beispiele korrigieren
- Umstieg von einem anderen Anbieter
- Versionierung und Modelländerungen
- Ist Synderesis ein nachtrainiertes Modell?
- Merkt sich die API ein Gespräch?
- Kann ich direkt aus einem Browser oder einer mobilen App aufrufen?
- Werden offizielle Quellen immer zurückgegeben?
- Belegt grounding_status, dass die Antwort validiert wurde?
- Werden alle Methoden des OpenAI SDK unterstützt?
- Gibt es ein kostenloses, wiederkehrendes API-Kontingent?
- Ist die gesamte Verarbeitung nur in der EU oder mit Null-Aufbewahrung?
Verwenden Sie beim Umzug einer Integration ausdrückliche Modell- und Parameterauswahlen. Die Unterstützung für Chat Completions im OpenAI-Format ist eine Teilmenge eines API-Vertrags, keine pauschale Kompatibilität mit jeder SDK-Funktion.
Migrationscheckliste
- Ändern Sie die Basis-URL des Clients auf https://www.synderesis.eu/v1 und geben Sie einen Synderesis-Kundenschlüssel an.
- Wählen Sie ausdrücklich ein unterstütztes Modell. Bevorzugen Sie synderesis-spark für den Transkript-Chat; verwenden Sie pro oder synderesis-pro mit tools=[] für ein Pro-Transkript. Ein weggelassenes Modell wählt die automatische Auswahl, die den Antwortpfad einschlägt.
- Entfernen Sie nicht unterstützte oder ignorierte Felder, nachdem Sie die Kompatibilitätstabelle geprüft haben.
- Wählen Sie den Parameter für die Ausgabeobergrenze des ausgewählten Pfads.
- Aktualisieren Sie die Antwortverarbeitung für nullfähige Tool-Call-Inhalte, optionale Metadaten und Nutzungs-Chunks im Stream.
- Prüfen Sie das Verhalten bei Wiederholungen, Zeitüberschreitungen und der Verbrauchsmessung von Fehlschlägen.
- Prüfen Sie das Kontokontingent, den aktuellen Tarif und die Bedingungen zur Datenverarbeitung.
- Führen Sie vor dem Produktionseinsatz einen begrenzten End-to-End-Test durch.
Ältere Synderesis-Beispiele korrigieren
| Frühere Annahme | Aktuelle Integrationsaktion |
|---|---|
| model=synderesis-pro wird abgelehnt | Es wird jetzt als dieselbe Auswahl wie pro akzeptiert, sowohl für answers als auch für chat completions. |
| Das Weglassen von model wählt Spark aus | Ein weggelassenes model ist die automatische Auswahl (synderesis-auto); senden Sie spark ausdrücklich, um Spark beizubehalten. |
| spark und synderesis-spark sind im Chat austauschbar | Wählen Sie den beabsichtigten Verarbeitungspfad ausdrücklich. synderesis-spark bewahrt das Transkript; spark ohne Tools verwendet den Antwortadapter für die letzte Nutzernachricht. |
| Das Weglassen von model ergibt einen Endpunkt für die vollständige Unterhaltung | Ein weggelassenes model nimmt den Antwortpfad mit automatischer Auswahl. Geben Sie synderesis-spark an, um das Verhalten mit vollständigem Transkript zu erhalten. |
| structured_answer enthält geparste Antwortabschnitte | Im geprüften nativen Antwort-Handler ist es null. Lesen Sie answer und prüfen Sie die Quellenmetadaten getrennt. |
| Chat-Quellen erscheinen in der adaptierten Antwort | Verwenden Sie /v1/answers, wenn Sie retrieved_sources/source_refs benötigen. |
| Jedes Max-Token-Feld funktioniert auf jedem Pfad | Answers/adapter verwenden max_tokens; der Transkript-Chat unterstützt max_completion_tokens mit Vorrang. |
| Jede Chat-Anfrage kann Tokens live streamen | Der Transkriptpfad liefert gepuffertes SSE; der Antwortpfad, einschließlich der automatischen Auswahl, lehnt stream=true ab. |
| Die Nutzung ist die kostenlose Zuteilung des aktuellen Monats | Die Anfangszuteilung ist einmalig, und die Nutzung erstreckt sich über Zeiträume, einschließlich ausstehender Reservierungen. |
| Fehlgeschlagene Generierungen werden nie gemessen | Abgesendete Hilfsarbeit oder abgesendete uneindeutige Arbeit kann gemessen werden. |
| Idempotenz garantiert eine Generierung | Die Abrechnungsidentität begründet weder die Wiedergabe einer zwischengespeicherten Antwort noch eine genau einmalige Inferenz. |
Wechsel von einem anderen Anbieter
Verwenden Sie die Kompatibilitätsmatrix. Diese API bietet über die Kundenendpunkte in diesem Leitfaden nicht die Schnittstellen OpenAI Responses, Assistants, Embeddings, Bilderzeugung, Audio oder Dateiupload an.
Ein aufgeführter Produktalias darf nicht als Nachweis dafür gedeutet werden, dass das Modell hinter dem gleichen oder ähnlichen Namen eines anderen Anbieters verwendet wird. Produktbezeichnungen, Kontextmetadaten und die tatsächliche Bereitstellungskonfiguration sind unterschiedliche Tatsachen.
Testen Sie Ihre Prompts mit repräsentativen Aufgaben und bewerten Sie Qualität, Latenz und Kosten selbstständig. Nehmen Sie nicht an, dass ein Parameter eine Wirkung hat, nur weil der Server ihn akzeptiert hat.
Versionierung und Modelländerungen
Der gehostete Pfad verwendet /v1. Die geprüfte Implementierung veröffentlicht keinen Mechanismus zum Anheften von Modell-Snapshots, kein formales Fenster für die API-Abkündigung und keinen allgemeinen Migrations-Header.
Pflegen Sie eigene Regressionsfälle und erfassen Sie den öffentlichen Alias sowie die relevanten Antwort-/Anfrage-IDs. Ein Produkt-Alias ist keine Garantie, dass der zugrunde liegende Checkpoint unveränderlich ist. Wo Provenienz oder Änderungskontrolle vertraglich geregelt ist, bestätigen Sie das bei Synderesis.
Diese Dokumentation hält die Implementierung fest, die am 6. November 2026 geprüft und am 7. November 2026 anhand der Quelle aktualisiert wurde. Eine geänderte Bereitstellung sollte eine neue Prüfung der Quelle und des Verhaltens auslösen.
Ist Synderesis ein nachtrainiertes Modell?
Die offizielle Beschreibung lautet nachtrainiertes KI-Modell oder, sofern technisch angemessen, nachtrainiertes KI-Modell mit offenen Gewichten. API-Aliasse kennzeichnen Dienstrouten und lassen für sich genommen nicht erkennen, welcher Checkpoint eine bestimmte Anfrage bearbeitet hat. Bestätigen Sie die Serving-Anordnung der ausgewählten Bereitstellung, wenn Ihre Integration ein bestimmtes nachtrainiertes Modell erfordert.
Der Qualifikator „open-weight“ verspricht für sich genommen nicht, dass Synderesis seine nachtrainierten Gewichte verteilt, dass jede Softwarekomponente Open Source ist oder dass ein gehosteter Dienst offline läuft.
Merkt sich die API eine Konversation?
Die Transkript-Schnittstelle verarbeitet die Nachrichten, die Sie jedes Mal übergeben. Die dokumentierten nativen Completion-Handler erstellen keinen serverseitigen Datensatz des Konversationsverlaufs. Ihre Anwendung muss den Kontext, den sie benötigt, und ihre eigene Aufbewahrungsrichtlinie pflegen. Nutzung/Abrechnung und die Verarbeitung durch den Anbieter bleiben getrennte Datenflüsse.
Kann ich direkt aus einem Browser oder einer mobilen App aufrufen?
Bewahren Sie den Kundenschlüssel auf Ihrem Backend auf. Die Kunden-API aktiviert kein Browser-CORS. Ein mobiles Bundle kann einen gemeinsamen, langlebigen Kundenschlüssel ebenfalls nicht sicher enthalten.
Werden offizielle Quellen immer zurückgegeben?
Answers verwendet standardmäßig den Abruf offizieller Quellen, aber eine Abfrage kann keine Passagen zurückgeben, oder die Auswahl kann sie auslassen. Setzen Sie grounding=false, um den Abruf zu deaktivieren. Die Chat-Schnittstelle Transkript/Tool führt die Pipeline zum Quellenabruf des Antwort-Endpunkts nicht automatisch aus.
Beweist grounding_status, dass die Antwort validiert wurde?
Nein. Im geprüften nativen Antwort-Handler ist retrieved_sources_only eine feste Bezeichnung und structured_answer ist null. Prüfen Sie die zurückgegebenen Quellen und verifizieren Sie wichtige Behauptungen anhand der Originale.
Werden alle Methoden des OpenAI SDK unterstützt?
Nein. Ausgewählte Methoden von Chat Completions können mit einer benutzerdefinierten Basis-URL verwendet werden. Die dokumentierte Teilmenge, die exakten Client-Versionen, die geprüft wurden, und die Einschränkungen sind unter SDKs und Beispiele aufgeführt.
Gibt es ein kostenloses wiederkehrendes API-Kontingent?
Die Startzuteilung ist einmalig. Sie wird nicht monatlich aufgefüllt. Abonnements, Guthaben und jeder gesondert vereinbarte kommerzielle Dienst haben jeweils eigene Bedingungen.
Ist die gesamte Verarbeitung ausschließlich in der EU oder ohne jede Aufbewahrung?
Diese Eigenschaften ergeben sich weder aus dem öffentlichen Alias noch aus dem Standort des Unternehmens. Prüfen Sie Sicherheit und Umgang mit Daten und holen Sie die aktuellen Vorkehrungen für Ihre ausgewählte Bereitstellung ein.