Przejdź do dokumentacji

SYNDERESIS / API UTRZYMANIE

Hostowane API dla klientów · Kontrakt przejrzany 7 listopada 2026

Migracja i FAQ

Na tej stronie

Przy przenoszeniu integracji stosuj jawne wybory modelu i parametrów. Obsługa Chat Completions w formacie OpenAI jest podzbiorem kontraktu API, a nie zgodnością obejmującą każdą funkcję SDK.

Lista kontrolna migracji

  1. Zmień bazowy URL klienta na https://www.synderesis.eu/v1 i podaj klucz klienta Synderesis.
  2. Wybierz jawnie obsługiwany model. Do czatu transkryptu preferuj synderesis-spark; do transkryptu Pro użyj pro lub synderesis-pro z tools=[]. Pominięty model wybiera automatyczny wybór, który obiera ścieżkę odpowiedzi.
  3. Usuń nieobsługiwane lub ignorowane pola po sprawdzeniu tabeli zgodności.
  4. Wybierz parametr limitu wyjścia dla wybranej ścieżki.
  5. Zaktualizuj obsługę odpowiedzi dla dopuszczającej null treści wywołań narzędzi, opcjonalnych metadanych i fragmentów użycia strumienia.
  6. Sprawdź zachowanie ponawiania, limitu czasu i naliczania niepowodzeń.
  7. Sprawdź limit konta, bieżącą taryfę i warunki przetwarzania danych.
  8. Przeprowadź ograniczony test end-to-end przed użyciem produkcyjnym.

Popraw starsze przykłady Synderesis

Wcześniejsze założenie Bieżące działanie integracyjne
model=synderesis-pro jest odrzucany Jest teraz akceptowany jako ten sam wybór co pro, zarówno dla answers, jak i dla chat completions.
Pominięcie parametru model wybiera Spark. Pominięty model jest wyborem automatycznym (synderesis-auto); wyślij spark jawnie, aby zachować Spark.
spark i synderesis-spark są wymienne w czacie Wybierz jawnie zamierzoną ścieżkę obsługi. synderesis-spark zachowuje transkrypt; spark bez narzędzi używa adaptera odpowiedzi dla ostatniej wiadomości użytkownika.
Pominięcie parametru model daje punkt końcowy pełnej rozmowy. Pominięty model obiera ścieżkę odpowiedzi z automatycznym wyborem. Podaj synderesis-spark, aby uzyskać zachowanie pełnego transkryptu.
structured_answer zawiera sparsowane sekcje odpowiedzi W sprawdzonym natywnym handlerze odpowiedzi jest null. Odczytaj answer i sprawdź metadane źródeł osobno.
Źródła czatu pojawiają się w zaadaptowanej odpowiedzi Użyj /v1/answers, gdy potrzebujesz retrieved_sources/source_refs.
Każde pole max-token działa na każdej ścieżce Answers/adapter używają max_tokens; czat transkryptu obsługuje max_completion_tokens z pierwszeństwem.
Każde żądanie czatu może strumieniować tokeny na żywo Ścieżka transkryptu udostępnia buforowane SSE; ścieżka odpowiedzi, w tym automatyczny wybór, odrzuca stream=true.
Użycie to bezpłatny przydział bieżącego miesiąca Początkowy przydział jest jednorazowy, a użycie rozciąga się na okresy, w tym na oczekujące rezerwacje.
Nieudane generacje nigdy nie są naliczane Pomocnicza lub niejednoznaczna wysłana praca może być naliczana.
Idempotencja gwarantuje jedną generację Tożsamość rozliczeniowa nie przesądza o odtworzeniu odpowiedzi z pamięci podręcznej ani o inferencji dokładnie jeden raz.

Przejście od innego dostawcy

Użyj macierzy zgodności. Ten interfejs API nie oferuje interfejsów OpenAI Responses, Assistants, embeddings, generowania obrazów, audio ani przesyłania plików przez punkty końcowe dla klientów w tym przewodniku.

Wymienionego aliasu produktu nie wolno interpretować jako dowodu, że używany jest model stojący za taką samą lub podobną nazwą innego dostawcy. Etykiety produktów, metadane kontekstu i rzeczywista konfiguracja serwowania to różne fakty.

Przetestuj prompty na reprezentatywnych zadaniach i niezależnie oceń jakość, opóźnienie i koszt. Nie zakładaj, że parametr wywołuje efekt tylko dlatego, że serwer go zaakceptował.

Wersjonowanie i zmiany modeli

Hostowana ścieżka używa /v1. Przejrzana implementacja nie publikuje mechanizmu przypinania migawki modelu, formalnego okna wycofania API ani ogólnego nagłówka migracji.

Utrzymuj własne przypadki regresji i zapisuj publiczny alias oraz odpowiednie identyfikatory odpowiedzi/żądań. Alias produktu nie stanowi gwarancji, że checkpoint leżący u jego podstaw jest niezmienny. Gdy proweniencja lub kontrola zmian ma charakter umowny, potwierdź to u Synderesis.

Ta dokumentacja rejestruje implementację przejrzaną 6 listopada 2026 i zaktualizowaną względem źródła 7 listopada 2026. Zmienione wdrożenie powinno wywołać nowy przegląd źródła i zachowania.

Czy Synderesis jest modelem poddanym ponownemu treningowi?

Oficjalny opis to model AI poddany ponownemu treningowi lub, gdy jest to technicznie właściwe, model AI o otwartych wagach poddany ponownemu treningowi. Aliasy API identyfikują trasy usług i same w sobie nie pozwalają ustalić, który checkpoint obsłużył dane żądanie. Potwierdź sposób serwowania wybranego wdrożenia, jeśli Twoja integracja wymaga konkretnego modelu poddanego ponownemu treningowi.

Kwalifikator open-weight sam w sobie nie obiecuje, że Synderesis rozpowszechnia swoje wagi poddane ponownemu treningowi, że każdy komponent oprogramowania jest oprogramowaniem open source ani że hostowana usługa działa offline.

Czy API pamięta konwersację?

Interfejs transkryptu przetwarza wiadomości, które przekazujesz za każdym razem. Udokumentowane natywne handlery completion nie tworzą serwerowego zapisu historii konwersacji. Twoja aplikacja musi utrzymywać potrzebny jej kontekst oraz własną politykę przechowywania. Użycie/rozliczanie i przetwarzanie przez dostawcę pozostają odrębnymi przepływami danych.

Czy mogę wywoływać bezpośrednio z przeglądarki lub aplikacji mobilnej?

Przechowuj klucz klienta na swoim backendzie. API klienta nie włącza CORS dla przeglądarki. Pakiet mobilny również nie może bezpiecznie zawierać współdzielonego, długotrwałego klucza klienta.

Czy oficjalne źródła są zawsze zwracane?

Answers domyślnie korzysta z pobierania oficjalnych źródeł, ale zapytanie może nie zwrócić żadnych fragmentów albo wybór może je pominąć. Ustaw grounding=false, aby wyłączyć pobieranie. Interfejs czatu transkrypt/narzędzie nie uruchamia automatycznie potoku pobierania źródeł punktu końcowego odpowiedzi.

Czy grounding_status dowodzi, że odpowiedź została zwalidowana?

Nie. W przejrzanym natywnym handlerze odpowiedzi retrieved_sources_only jest stałą etykietą, a structured_answer jest null. Sprawdź zwrócone źródła i zweryfikuj ważne twierdzenia względem oryginałów.

Czy wszystkie metody OpenAI SDK są obsługiwane?

Nie. Wybrane metody Chat Completions można stosować z niestandardowym bazowym adresem URL. Udokumentowany podzbiór, dokładne wersje klientów, które sprawdzono, i ograniczenia są wymienione w SDK i przykłady.

Czy istnieje bezpłatny, cykliczny przydział API?

Początkowy przydział jest jednorazowy. Nie jest uzupełniany co miesiąc. Subskrypcje, środki i każda osobno uzgodniona usługa komercyjna mają własne warunki.

Czy całe przetwarzanie odbywa się wyłącznie w UE lub bez żadnej retencji?

Te właściwości nie wynikają ani z publicznego aliasu, ani z lokalizacji firmy. Sprawdź Bezpieczeństwo i postępowanie z danymi i uzyskaj aktualne ustalenia dla swojego wybranego wdrożenia.

Przeczytaj ten przewodnik jako Markdown