Zur Dokumentation springen

SYNDERESIS / API PFLEGEN

Gehostete Kunden-API · Vertrag überprüft am 7. November 2026

Migration und FAQs

Auf dieser Seite

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

  1. Ändern Sie die Basis-URL des Clients auf https://www.synderesis.eu/v1 und geben Sie einen Synderesis-Kundenschlüssel an.
  2. 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.
  3. Entfernen Sie nicht unterstützte oder ignorierte Felder, nachdem Sie die Kompatibilitätstabelle geprüft haben.
  4. Wählen Sie den Parameter für die Ausgabeobergrenze des ausgewählten Pfads.
  5. Aktualisieren Sie die Antwortverarbeitung für nullfähige Tool-Call-Inhalte, optionale Metadaten und Nutzungs-Chunks im Stream.
  6. Prüfen Sie das Verhalten bei Wiederholungen, Zeitüberschreitungen und der Verbrauchsmessung von Fehlschlägen.
  7. Prüfen Sie das Kontokontingent, den aktuellen Tarif und die Bedingungen zur Datenverarbeitung.
  8. 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.

Lesen Sie diese Anleitung als Markdown