Przejdź do dokumentacji

SYNDERESIS / API EKSPLOATACJA

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

Limity, wykorzystanie i rozliczenia

Na tej stronie

Rozmiar żądania, długość wyniku, kontekst, przydział konta i środki to osobne ograniczenia. Większy kontekst modelu nie uchyla limitu bajtów ani limitu wyniku punktu końcowego.

Limity techniczne

Powierzchnia Limit lub zachowanie
Treść Answers 65 536 bajtów; większe treści zwracają 400 invalid_request.
Treść Chat Completions 921 600 bajtów (900 KiB); większe treści zwracają 400 invalid_request.
Pytanie Answer 16 000 znaków po trimowaniu; puste pytania są odrzucane.
Instrukcje Answer Trimowane i obcięte do 16 000 znaków.
Zapytanie retrieval Answer Pierwsze 8 000 znaków pytania.
Połączony kontekst źródeł Answer Co najwyżej 16 000 znaków; zbyt duże fragmenty mogą zostać pominięte.
Wynik Answers max_tokens ma wartość domyślną 1024 i jest ograniczane do 1–4096.
Wyjście adaptera odpowiedzi czatu max_tokens ma wartość domyślną 4096 i jest ograniczane do 1–4096.
Wyjście czatu transkryptu/narzędzi Liczba całkowita 1–32768; wartość domyślna 8192; max_completion_tokens ma pierwszeństwo.
Wiadomości transkryptu 1–255, w tym przekazane wiadomości system/developer i tool.
Niepuste definicje narzędzi 1–128 unikalnych funkcji; zserializowane definicje co najwyżej 512 KiB.
Argumenty wywołań narzędzi Obiekt JSON zakodowany jako ciąg znaków; co najwyżej 256 KiB na ciąg argumentów jednego wywołania.
Zapytanie o źródła Co najwyżej 8 000 znaków.
Wyniki źródeł Żądane 1–20; wartość domyślna 6.
Filtr źródeł POST Co najwyżej 100 ID, każdy co najwyżej 256 znaków.
Aktywne klucze klienta/rozszerzenia Do 10 na konto.
Współdzielony klucz wyłącznie do inferencji Limit tokenów na cały czas życia i wygaśnięcie zapisane w kluczu; zobacz poniżej.
Deklarowany kontekst synderesis-spark 65 536 tokenów w metadanych modelu; inne ograniczenia żądania pozostają w mocy.

Limity bajtów i znaków różnią się, zwłaszcza dla tekstu innego niż ASCII. Uwzględnij rzeczywistą treść JSON w UTF-8, łącznie z narzutem wiadomości i definicji narzędzi. API nie udostępnia ogólnego punktu końcowego do zliczania tokenów wejściowych.

Budżety completion mogą obejmować niewidoczne rozumowanie. Bardzo małe limity mogą nie pozostawić widocznej odpowiedzi; natywne handlery odrzucają pustą wygenerowaną odpowiedź. Zwiększ limit w udokumentowanym zakresie punktu końcowego podczas badania tego przypadku, zachowując budżet kosztów.

Przydziały i limity częstości żądań

Przydział klienta jest egzekwowany w całym koncie, łącznie z jego kluczami i jego użyciem przeglądarki. Oczekujące rezerwacje zużywają dostępną pojemność, dopóki żądanie jest w toku.

Jednorazowy bezpłatny przydział tokenów jest liczony przez kolejne okresy. Nie jest uzupełniany co miesiąc. Uprawniona płatna subskrypcja albo nieodpłatne przyznanie znosi to ograniczenie bezpłatnego przydziału. Niektóre konta niepłatne mają także dzienne/miesięczne limity żądań.

Liczbowe limity konta zależą od aprowizowanego uprawnienia i planu; publiczne punkty końcowe klienta nie podają uniwersalnego przydziału RPM, TPM ani współbieżności. Nie wyprowadzaj go z bazowych limitów modelu dostawcy.

  • 402 free_allocation_exhausted: początkowy przydział został wyczerpany; użyj Konta, aby zasubskrybować.
  • 402 insufficient_credit: rozliczana praca na ścieżce odpowiedzi nie ma środków; dodaj środki w Koncie.
  • 429 quota_exceeded: osiągnięto ograniczenie planu/konta; sprawdź Konto oraz właściwy limit/reset.
  • 429 rate_limited: na trasie, która go używa, osiągnięto ogranicznik żądań; odczekaj przed ponowieniem próby.
  • 402 inference_quota_exhausted: współdzielony klucz wyłącznie do inferencji nie może przyjąć nowego żądania w ramach swojego limitu na cały czas życia.

Przejrzana implementacja nie obiecuje przy tych błędach nagłówka Retry-After ani standardowych nagłówków odpowiedzi dotyczących limitów częstości. Użyj ich, jeśli są obecne, ale Twoja logika ponawiania musi działać bez nich. Wyszukiwanie źródeł może ujawnić problem przydziału/backendu jako 503; zobacz referencję.

Przy planowanym wolumenie integracji uzyskaj od Synderesis pojemność konta i ustalenia dotyczące usługi, zanim zobowiążesz się do przepustowości produkcyjnej. Ten przewodnik nie ustanawia SLA, gwarantowanego opóźnienia ani automatycznego procesu zwiększania kontyngentu.

Współdzielone klucze tylko do inferencji

Współdzielony klucz tylko do inferencji (prefiks sk_inf_, przeznaczenie inference_share) może wywoływać wyłącznie POST /v1/chat/completions, POST /v1/answers i GET /v1/models; każda inna trasa odpowiada HTTP 403 inference_scope_denied. Płatne uprawnienie i liczniki żądań go nie dotyczą; obowiązuje tylko jego zapisany limit tokenów na cały czas życia.

Przyjmowanie nowych żądań odrzuca nową rezerwację, gdy zapisany limit klucza na cały czas życia wynosi zero albo gdy już policzone tokeny wraz z nową rezerwacją przekroczyłyby ten limit (HTTP 402 inference_quota_exhausted). Policzone tokeny obejmują oczekujące rezerwacje oraz nieudane lub wygasłe rezerwacje bez użycia, w pełnym zarezerwowanym rozmiarze. Wystawiający operator zapisuje limit 2 000 000 łącznie tokenów wejściowych i wyjściowych. Zgłoszone użycie powyżej rezerwacji jest nadal rejestrowane, więc policzona suma może zakończyć się powyżej limitu. Limit nie jest zatrzymaniem po stronie dostawcy.

Nowe żądanie w chwili wygaśnięcia klucza lub później jest odrzucane (HTTP 401 unauthorized). Każdy hop u dostawcy jest tuż przed wysłaniem ponownie sprawdzany względem zegara bazy danych, więc hop, który nie został wysłany, również jest w tej chwili odrzucany. Hop, który został już wysłany, może się zakończyć, a jego tokeny nadal są liczone.

Poprawnie odczytuj użycie

GET /v1/usage zwraca użycie przydziału na cały czas życia, oczekujące rezerwacje, flagi uprawnień oraz informacyjne wartości środków w euro. Wynik dotyczy całego konta i nie jest sumą tokenów pojedynczego klucza ani bieżącego miesiąca.

Płatne konto może wykazywać zero pozostałych bezpłatnych tokenów i nadal mieć dostęp. Zwrócona liczba tokenów mierzy pracę API, a nie tylko znaki w ostatecznej odpowiedzi. Do wyniku mogą się przyczyniać kontekst systemowy, dostarczona historia, pobrany kontekst, praca wyboru fragmentów oraz, przy automatycznym wyborze, wywołanie routera.

Nie ma uniwersalnego stosunku znaków do tokenów. Niektóre ścieżki używają prawidłowych zliczeń dostawcy i w razie potrzeby wracają do ograniczonych oszacowań. Nie obiecuj dokładnego kosztu na podstawie lokalnej liczby znaków.

Subskrypcja i środki

Aktualna strona cennika opisuje warunki samoobsługi: jednorazowy bezpłatny przydział, wprowadzający miesiąc subskrypcji, o ile przysługuje, kontynuację subskrypcji oraz doładowania środków. W Koncie można wyświetlać swoje rzeczywiste uprawnienie i saldo oraz nimi zarządzać.

Publiczne warunki przejrzane 6 listopada 2026 wykazują 1 € za pierwszy uprawniony miesiąc subskrypcji, a następnie 5 €/miesiąc; środki odzwierciedlają rozliczoną płatność po opłatach procesora płatności oraz początkowe środki promocyjne. Są to warunki subskrypcji samoobsługowej; nie są obietnicą nieograniczonego użycia API, umową integracji partnerskiej ani zobowiązaniem dotyczącym przepustowości dla przedsiębiorstw.

Taryfy tokenów i szacowanie żądania

Stawki dla klientów zależą od trasy serwowania/produktu oraz od obowiązującej taryfy. Przejrzane źródło obejmuje standardowe taryfy tras zarządzanych oraz osobno konfigurowalną taryfę checkpointu po ponownym treningu. Nie wnioskuj o włączonej taryfie ani o fakturze wyłącznie na podstawie aliasu modelu.

Przed wdrożeniem komercyjnym uzyskaj obowiązujące stawki wejścia/wyjścia, przeliczenie waluty, traktowanie podatkowe, zaokrąglenie, opłaty za pracę pomocniczą oraz warunki naliczania przy niepowodzeniach. Strona cennika i Konto powinny zostać uzgodnione z tym ustaleniem.

Dla stawki wejściowej P i stawki wyjściowej C za milion tokenów:

kwota generowania = input_tokens × P / 1,000,000 + output_tokens × C / 1,000,000

Wyłącznie dla ilustracji 1,000 tokenów wejściowych i 250 tokenów wyjściowych przy przykładowych stawkach USD 1 i USD 2 za milion daje USD 0.0015 przed inną pracą lub korektami. Te przykładowe stawki nie są wyceną Twojej skonfigurowanej usługi.

Do monitorowania używaj zwróconego użycia oraz środków na koncie, a istotne różnice uzgadniaj ze wsparciem przy użyciu identyfikatorów żądań. GET /v1/usage nie jest API faktury z wyszczególnieniem pozycji.

Niepowodzenia, ponowienia i rezerwacje

Nie zakładaj, że nieudane żądanie jest bezpłatne. Praca wyboru fragmentów i routera może być naliczana nawet wtedy, gdy odpowiedź później się nie powiedzie. Ścieżka transkryptu/narzędzia może zapisać ograniczone oszacowanie po niejednoznacznym niepowodzeniu już wysłanej generacji.

Timeout klienta, zamknięte połączenie lub przerwany strumień nie przesądza o tym, że nie wykonano żadnej pracy. Ponowienia mogą wykonać dodatkową pracę i ją naliczyć. Zacznij od skromnych limitów wyjścia, ogranicz współbieżność we własnej aplikacji i zastosuj wskazówki dotyczące ponowień.

Czytaj ten przewodnik jako Markdown