Przejdź do treści

Referencja API

Uwierzytelnianie, endpointy, streaming, reasoning i błędy na powierzchni OpenAI, natywne API Anthropic oraz macierz zgodności per endpoint.

Uwierzytelnianie

Każde żądanie do /v1/* uwierzytelnia się wirtualnym kluczem w nagłówku Authorization: Bearer. Klucze tworzysz w Workloadach w Konsoli.

  • Sekret jest pokazywany raz, a przechowywany jest tylko jego hash.
  • Klucz uwierzytelnia workload. Workload zarządza limitami żądań, budżetem, dozwolonymi modelami i wyjątkami od polityki. Polityka organizacji nadal obowiązuje.
  • Klucz może mieć opcjonalną datę wygaśnięcia. Po niej jest odrzucany dokładnie tak jak nieznany klucz.
  • Model, którego nie ma na niepustej liście dozwolonych modeli workloadu, zostaje odrzucony zapieczętowanym 403 permission_error, zanim cokolwiek zostanie wysłane. Sama odmowa trafia do łańcucha audytu.
  • Workload może ograniczyć swoje klucze do rodzin endpointów, na przykład chat i embeddings. Pozostałe rodziny dostają zapieczętowany 403 operation_not_allowed, zanim cokolwiek zostanie wysłane.
  • Utworzenie klucza produkcyjnego wymaga zweryfikowanego adresu e-mail.
  • Jeden wyjątek: podpisane linki do pobrania zanonimizowanych dokumentów, ważne przez ograniczony czas, nie wymagają klucza.
Dane uwierzytelniające workloadu: zarządzaj kluczami API i ustawieniami dostępu.
Dane uwierzytelniające workloadu: zarządzaj kluczami API i ustawieniami dostępu.Interfejs angielski · przykładowe dane demonstracyjne. Otwórz obraz w pełnym rozmiarze.
curl https://api.sluis.ai/v1/models \
  -H "Authorization: Bearer $SLUIS_KEY"

# a model outside the workload's allow-list never dispatches:
# → 403 permission_error, and the refusal is sealed in the audit chain

Endpointy

Sluis udostępnia poniższą powierzchnię zgodną z OpenAI oraz natywne ścieżki Anthropic opisane dalej.

Endpointy bez dedykowanej obsługi są przekazywane dosłownie do wyznaczonego dostawcy, wraz ze streamingiem, więc zgodne z OpenAI usługi nadrzędne zachowują pełną wierność.

Przeglądarka, która otworzy ścieżkę nieobsługiwaną przez API, na przykład sam host API, zostaje przekierowana do tej dokumentacji. Klienci API nadal dostają zwykłe 404.

EndpointPrzeznaczenie
POST /v1/chat/completionsChat completions, główna powierzchnia: routing, ochrona danych, buforowanie, streaming.
POST /v1/completionsStarsze text completions.
POST /v1/embeddingsEmbeddingi.
POST /v1/moderationsKlasyfikacja moderacji.
POST /v1/responsesAPI OpenAI Responses.
POST /v1/systemoneNative System One typed decisions, not OpenAI chat messages.
POST /v1/ocrOCR dokumentów (Mistral, lub w pełni lokalnie z modelem sluis/ocr), rozliczany za stronę. Z włączoną polityką dlp_documents dokumenty inline są anonimizowane przed wysyłką.
POST /v1/documents/anonymizeAnonimizacja dokumentów: dane osobowe zamieniane na «MERGE_TAG»y, obrazy rozmywane. Rozliczana za stronę lub obraz.
POST /v1/documents/anonymize/jobsAsynchroniczne zadania anonimizacji: zakolejkuj duży dokument, sprawdzaj /jobs/{id} i pobierz /jobs/{id}/result. Podpisany link do pobrania (/v1/documents/deliverables/{id}) jest ważny przez ograniczony czas i nie wymaga klucza API.
GET /v1/modelsModele dozwolone przez twoją politykę, poświadczenia i workload, z typem, oknem kontekstu, możliwościami, rezydencją, celem aliasu i końcową ceną tej organizacji w EUR, bez VAT.
GET /v1/models/{id}Metadane i cena dla organizacji dla jednego modelu, w tym samym formacie co lista.
POST /v1/audio/*Transkrypcja, tłumaczenie i mowa, przekazywane do wyznaczonego dostawcy. Z modelem sluis/transcribe POST /v1/audio/transcriptions uruchamia własne rozpoznawanie mowy Sluis z rozpoznawaniem mówców. Zobacz Mowa na tekst.
POST /v1/images/*Generowanie i edycja obrazów, przekazywane. Wyjątkiem jest mistral/image-generation: Mistral udostępnia je wyłącznie przez swój konektor agenta, więc gateway tłumaczy żądanie OpenAI i odpowiada w b64_json, rozliczane za obraz.
POST /v1/video/generationsGenerowanie wideo, przekazywane.
/v1/filesOperacje na plikach, przekazywane z własnym kluczem Twojej organizacji (BYOK lub własny dostawca). Wyjątkiem są pliki z purpose=batch: przechodzą przez własną bramkę gatewaya i mogą używać kluczy zarządzanych.
/v1/batchesPartie w formacie OpenAI: wyślij plik JSONL z purpose=batch do /v1/files, potem twórz, sprawdzaj i anuluj tutaj. Każdy wiersz przechodzi ochronę danych i rezydencję jak wywołanie na żywo. Wyniki w ciągu 24 godzin, rozliczane po połowie ceny na żywo. Mistral, Azure, OpenAI i Qwen.
POST /v1/messages/batchesAnthropic Message Batches: create, list, get, results i cancel. Wyłączone, o ile wdrożenie ich nie włącza. Wymagają retencji treści i działają tylko na modelach Anthropic. W przeciwnym razie te trasy zwracają 404.
POST /v1/messagesNatywne wejście Anthropic Messages: skieruj dowolne narzędzie z SDK Anthropic na Sluis, z dowolnym podłączonym modelem.
POST /v1/messages/count_tokensLokalne oszacowanie tokenów dla zarządzania kontekstem SDK Anthropic. Nic nie jest wysyłane.
GET /anthropic/v1/modelsNatywne odkrywanie modeli Anthropic (list i get), z katalogu w procesie. Na /v1/models ten sam format wybiera nagłówek anthropic-version.
HEAD /api/helloSonda rozgrzewkowa dla klientów SDK Anthropic, takich jak Claude Code: 200 z pustym ciałem.
GET /v1/realtimeWebSocket zgodny z OpenAI Realtime do rozmów głosowych na żywo (speech to speech) z vertex/gemini-3.8-live, hostowany w multiregionie UE w Google Vertex AI. Dostępny także pod /openai/v1/realtime; parametr zapytania model jest wymagany. Uwierzytelnij żądanie upgrade nagłówkiem Authorization: Bearer lub x-api-key. Używa nazw zdarzeń GA; formaty beta OpenAI-Beta: realtime=v1, efemeryczne sekrety klienta, klucze w subprotokole przeglądarki i audio G.711 nie są obsługiwane. Narzędzia po stronie serwera, wznawianie sesji, replikacja głosu i wyjście awatara są odrzucane przy konfiguracji. Tekst jest chroniony jak w każdym endpoincie; ramki audio i wideo są przekazywane bez inspekcji. Sesja kończy się po osiągnięciu limitu wydatków 2 EUR, a dostawca zamyka połączenie po około 10 minutach; połącz się ponownie, aby kontynuować. Rozliczenie za token według stawek modelu dla poszczególnych modalności (tekst, audio, ramki obrazu i wideo), na podstawie raportu zużycia dostawcy. Niedostępne w Sluis Workspace, Playground ani aliasach sluis/*. Pełna lista zdarzeń jest w agent skill.
GET /ws/google.ai.generativelanguage.v1beta.GenerativeService.BidiGenerateContentNatywny WebSocket Gemini Live (BidiGenerateContent), także pod /ws/google.cloud.aiplatform.v1.LlmBidiService/BidiGenerateContent; wersja w nazwie usługi może mieć wartość v1, v1beta, v1beta1 lub v1alpha. SDK google-genai z origin gateway jako bazowym URL łączy się bez zmian. Uwierzytelnij żądanie upgrade nagłówkiem x-goog-api-key, Authorization: Bearer lub x-api-key; parametr zapytania ?key= nie jest akceptowany. Ramki są przekazywane tak, jak definiuje je protokół Gemini Live, a setup.model to gemini-3.8-live. Odmowy przychodzą jako ramka zamknięcia WebSocket z powodem w tekście. Ten sam model, te same limity, ta sama ochrona danych i to samo rozliczanie co /v1/realtime.
curl https://api.sluis.ai/v1/chat/completions \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "mistral/mistral-large-latest",
        "messages": [{ "role": "user", "content": "Say hi" }] }'
Playground z wybranym modelem i ukończonym przykładowym żądaniem.
Playground z wybranym modelem i ukończonym przykładowym żądaniem.Interfejs angielski · przykładowe dane demonstracyjne. Otwórz obraz w pełnym rozmiarze.

Każde powyższe ciało JSON może dodatkowo nieść rozszerzenie gateway sluis.remove, wskazujące terminy, które trzeba spseudonimizować w prompcie przed wysyłką. Jest usuwane, zanim żądanie opuści gateway; zobacz Referencji ochrony danych.

# Document OCR, billed per page. Returns pages[] markdown + usage_info.pages_processed.
# model "sluis/ocr" runs the gateway's own OCR engine: fully local, no provider egress (inline data: URLs only).
curl https://api.sluis.ai/v1/ocr \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "mistral/mistral-ocr-latest", "document": { "type": "document_url", "document_url": "https://example.com/invoice.pdf" } }'

Mowa na tekst z rozpoznawaniem mówców

Ustaw model sluis/transcribe i wyślij POST /v1/audio/transcriptions. Gateway uruchamia własne rozpoznawanie mowy, bez wysyłania danych do dostawców.

  • Wyślij plik multipart file do 240 minut. Język jest wykrywany automatycznie.
  • response_format to json (domyślnie), text lub verbose_json (segmenty z mówcą).
  • Rozliczane po 0,02 € za minutę nagrania, za każdą rozpoczętą sekundę.
  • Tryb DLP organizacji obejmuje transkrypcję, tak jak przy sluis/ocr.
  • Odpowiada 503 tam, gdzie wdrożenie nie uruchamia transkrypcji.
# Speech to text with speaker detection, billed €0.02 per minute of audio (per started second).
# model "sluis/transcribe" runs in the gateway's own worker: no provider egress, language detected automatically.
curl https://api.sluis.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -F model=sluis/transcribe \
  -F response_format=verbose_json \
  -F file=@meeting.m4a
# Document anonymization, billed per page/image. PII becomes «MERGE_TAG»s; images are blurred.
curl https://api.sluis.ai/v1/documents/anonymize \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -F file=@contract.docx \
  -F 'options={ "entities": ["person_name", "email", "iban"], "remove": ["Project Nightingale"] }'
Playground Documents: prześlij dokument do anonimizacji.
Playground Documents: prześlij dokument do anonimizacji.Interfejs angielski · przykładowe dane demonstracyjne. Otwórz obraz w pełnym rozmiarze.

System One typed decisions

# The router behind sluis/auto: send state only, not questions.
curl https://api.sluis.ai/v1/systemone \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"sluis/typed/router",
       "state":{"request":"Compare these two supplier contracts clause by clause and list the risks.",
                "previous":"Here are both contracts.",
                "attachments":["contract_a.pdf (application/pdf)","contract_b.pdf (application/pdf)"]}}'
Local router contract (sluis/typed/router)Behaviour
Model idssluis/typed/router is the router Sluis uses for sluis/auto, with its own calibrated questions. For your own questions, use a typesafe/jev-* model with your own TypeSafe key.
sluis/typed/routerSend the text a request carries: state.request (required), and optional previous, system and attachments (a string or a list of "name (mime)" strings); a plain string is the request. It answers reasoning (noul, P(needs multi-step reasoning)), complexity (score, 0 trivial to 3 hard, with legend and probabilities per level) and task (choice over code, writing, translation, extraction, document, support, smalltalk, action). decision holds the route and demand sluis/auto would take from this text alone, or null. Files, images, JSON mode, tools, prompt size and your organisation's policy are not part of this input and can change a real sluis/auto route. answers.reasoning keeps the keys it always had; the rest is additional.
TypeSafeBring your own key only; no sluis/* alias reaches it. Name the model explicitly, for example typesafe/jev-latest. The normal gate applies: it is a US provider, so your residency policy must allow US. The other rows describe sluis/typed/router only.
AvailabilityEvery answer comes from verified model weights, reported as revision. If the router is unavailable or cannot be verified, the call fails closed with 503.
StateRequired JSON object, list (array) or string, at most 128 KiB (131072 bytes) of serialized JSON before DLP. Missing or invalid state returns 422; oversized state returns 413.
Questionssluis/typed/router supplies its own calibrated questions: any questions field, including null or an empty object, returns 400.
ResponseJSON with model, answers, decision and revision (weights SHA256). Each answer has its type, its typed value (choice, score or noul), confidence, probabilities, legend and answer_confidence. No chat completion or streaming envelope.
Latencysluis/typed/router usually answers well under 200 ms; when busy it returns 503 with Retry-After: 2.
Data protectionTenant DLP applies locally to the state: block refuses; tokenize or mask rewrites what the router is shown. Per-request removal terms are honoured.
ResidencyProcessed on Sluis infrastructure with no outside provider and no upstream residency routing step.
MeteringEach successful local decision is sealed and billed per input token at €0.01 per 1M tokens; output is free. The router reports no token count, so input is estimated at about 4 characters per token over the state it was shown. Normal limits, budgets and model allow-lists still apply.
AliasesAn existing tenant alias with the same name takes precedence over the local router.

Dokumenty na wejściu

Dołącz PDF, dokument Word, obraz lub plik tekstowy do żądania czatu jako część treści "type": "file" z adresem data URL file_data w base64.

Zaakceptuje to każdy wybrany model. Dostawcy, którzy natywnie rozumieją części plikowe, dostają je bez zmian. Dla wszystkich pozostałych gateway konwertuje dokument przed wysyłką.

Jak model otrzymuje dokument

  • Z rendererem PDF modele z widzeniem dostają każdą stronę PDF jako część image_url. Budżet to 48 stron na żądanie, wspólny dla wszystkich załączonych dokumentów, a mogą obowiązywać też limity dostawcy. Bez renderera rozwiązanie zastępcze wdrożenia wyodrębnia tekst albo odmawia.
  • Modele bez wejścia obrazowego dostają możliwy do wyodrębnienia tekst dokumentu jako tekst promptu. Skan ochrony danych obejmuje go potem jak każdy inny tekst.
  • Dłuższe lub cięższe dokumenty należą do /v1/ocr.
  • API Responses przyjmuje części input_file zamiast zagnieżdżonego kształtu file z chat completions.
  • Sluis nie może sprawdzić ani rozwiązać referencji file_id po stronie dostawcy. Przechodzą one tylko do dostawcy, który je obsługuje, na Twoim własnym kluczu dostawcy, przy wyłączonej inspekcji dokumentów. W przeciwnym razie osadź bajty jako file_data.

Ochrona danych dla dokumentów

  • Z włączoną polityką dlp_documents dokument jest anonimizowany lub odrzucany, zanim cokolwiek opuści gateway.
  • Gdy jest wyłączona, a tryb DLP jest ochronny (tokenize, mask lub block), dokumenty, które podróżowałyby jako niemożliwe do zbadania obrazy, są odrzucane. Przy allow_log przechodzą z jawnym znacznikiem braku skanowania w dzienniku audytu.
  • Części audio (input_audio) nie mogą być skanowane. block lub wymagane rozpoznawanie AI przy włączonej kontroli dokumentów odrzuca je kodem 422. W przeciwnym razie mają x-sluis-unscanned: audio.
# Attach a document as an OpenAI-style `file` content part. The gateway
# normalizes it for the routed provider, so this works on any model.
curl https://api.sluis.ai/v1/chat/completions \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "scaleway/gemma-4-26b-a4b-it",
        "messages": [{ "role": "user", "content": [
          { "type": "file",
            "file": { "filename": "drawing.pdf",
                      "file_data": "data:application/pdf;base64,'"$(base64 -w0 drawing.pdf)"'" } },
          { "type": "text", "text": "Which discipline does this drawing document?" }
        ] }] }'

Streaming

Ustaw stream: true, a odpowiedź nadejdzie jako server-sent events. Każda ramka to delta chat.completion.chunk, a strumień kończy się data: [DONE].

Strumienie nigdy nie są buforowane w gatewayu: przepływają przez niego rozgałęzieniem (tee), a zapieczętowanie audytu i pomiar następują nawet wtedy, gdy klient rozłączy się wcześniej.

Poproś o stream_options.include_usage, a gateway zażąda od dostawcy końcowej ramki ze zużyciem. Jeśli dostawca jej nie wyśle albo strumień zostanie przerwany, gateway oszacuje zużycie na potrzeby pomiaru.

Chcesz zobaczyć, ile kosztowało Twoją organizację wywołanie ze strumieniowaniem? Wyślij x-sluis-include-cost: true razem z stream_options.include_usage. Końcowy obiekt usage zawiera wtedy sluis_cost_eur, zobacz Koszt wywołania.

Bedrock oddziela rozumowanie od odpowiedzi w reasoning_content i reasoning_signature, także w przesyłanych deltach. Odmowy używają finish_reason: content_filter, a limity wyjścia length, również przy częściowych wywołaniach narzędzi. Nie wykonuj niekompletnych argumentów narzędzi. Wyjątki strumienia AWS stają się ramkami błędów bez poufnych szczegółów.

Keepalive, nagłówki i restarty

  • Po 15 sekundach bez ramki gateway zapisuje między zdarzeniami linię komentarza SSE (: keepalive), aby proxy z limitem bezczynności utrzymywały połączenie, gdy model myśli. Klienci SSE ją ignorują.
  • Strumienie mają nagłówki Cache-Control: no-cache i X-Accel-Buffering: no.
  • Gdy replika gatewaya się restartuje, obsługuje otwarte strumienie jeszcze do pięciu minut. Strumień otwarty dłużej kończy się zdarzeniem błędu z kodem server_restarting, więc ponów żądanie.
  • Strumienie z tokenizacją akceptują pojedyncze zdarzenia do 4 MiB. Większe zdarzenia kończą strumień błędem.
stream = client.chat.completions.create(
    model="mistral/mistral-large-latest",
    messages=[{"role": "user", "content": "Write a haiku"}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Rozumowanie

Przekaż parametr OpenAI reasoning_effort (minimal | low | medium | high) na dowolnym modelu zdolnym do myślenia. Sluis tłumaczy go zależnie od dostawcy (poziom myślenia Gemini, adaptacyjny wysiłek myślowy Claude) i pomija go tam, gdzie model by go odrzucił, więc jeden parametr działa w całym katalogu.

resp = client.chat.completions.create(
    model="vertex/claude-opus-4-8",
    messages=[{"role": "user", "content": "Prove it step by step…"}],
    reasoning_effort="high",  # minimal | low | medium | high
)

Cache promptów

Powtarzające się prefiksy promptów (prompty systemowe, narzędzia, historia rozmowy) mogą być cache'owane u dostawcy, co zmniejsza koszt i opóźnienia. Sluis tłumaczy bloki cache_control w stylu Anthropic (opcjonalny TTL 5m lub 1h) oraz najwyższego poziomu prompt_cache_key i prompt_cache_retention z OpenAI, zależnie od dostawcy.

Wiele granic punktów podziału system lub assistant może zostać scalonych podczas tłumaczenia, także przy różnych TTL.

DostawcaZachowanie cache promptów
AnthropicJawne cache_control na blokach systemowych, treści i narzędziach, wraz z TTL. Odczyty i zapisy są raportowane osobno.
Bedrockcache_control staje się blokami cachePoint Converse w system, messages i toolConfig.
OpenAI · AzureAutomatyczny cache. Po włączeniu prompt_cache_key i prompt_cache_retention pozostają w chat i Responses; nieobsługiwane opcje i markery są usuwane.
Gemini · VertexDziała niejawny cache Gemini i raportowanie zużycia; jawne odwołania cachedContent nie są obsługiwane. Claude na Vertex tłumaczy cache_control i TTL jak Anthropic.
xAI · DeepSeek · Mistral · Qwen · Moonshot · ZhipuAutomatyczny cache, jeśli jest dostępny; wszystkie jawne dyrektywy są usuwane. Natywne usage.cached_tokens Moonshot jest rozpoznawane.
ScalewayAutomatyczny cache, jeśli jest dostępny; wszystkie jawne dyrektywy są usuwane. Odczyty korzystają z oficjalnej stawki Scaleway w EUR dla wejścia z cache, jeśli jest dostępna, nie z LiteLLM.
NebulAutomatyczny cache, jeśli jest dostępny; wszystkie jawne dyrektywy są usuwane. Odczyty korzystają z oficjalnej stawki w EUR dla wejścia z cache, jeśli jest dostępna.
Nebius · nebius-euAutomatyczny cache, jeśli jest dostępny; wszystkie jawne dyrektywy są usuwane. Oficjalne ceny nie używają rabatów cache LiteLLM; fallback LiteLLM może dostarczyć stawkę cache, gdy brak oficjalnej ceny modelu.
CustomPo włączeniu przez organizację dyrektywy są przekazywane bez zmian; obsługa zależy od umowy operatora.

Jawny cache promptów jest opcjonalny

Jawny cache promptów to ustawienie na poziomie organizacji (provider_prompt_cache). Jest domyślnie wyłączony i niezależny od retencji treści Sluis oraz cache identycznych odpowiedzi. Włącz go w Konsola › Ochrona danych.

  • Zbuforowane prefiksy pozostają u dostawcy po przefiltrowaniu przez ochronę danych Sluis.
  • Gdy jest wyłączony, gate usuwa prompt_cache_key, prompt_cache_retention, prompt_cache_options, cache_control i prompt_cache_breakpoint. Nie wyłącza własnego, automatycznego cache dostawcy.
  • Bez własnego klucza do dostawcy wywołania korzystają z poświadczeń Sluis współdzielonych z innymi organizacjami. W OpenAI i Azure Sluis ustawia prompt_cache_key wyprowadzony z Twojej organizacji zamiast Twojego. U każdego innego dostawcy liczby tokenów z cache w Twoim zużyciu pokazują 0. Rozliczenie nadal stosuje prawdziwy rabat za cache.

Rozliczenia i limity

  • Odczyty i zapisy cache są częścią łącznej liczby tokenów promptu, nie dodatkowym wejściem. Odczyty używają dostępnej stawki cache.
  • Zapisy Anthropic 1h używają stawki dla danego TTL, gdy dostępny jest podział zużycia i taryfa. W przeciwnym razie obowiązuje domyślna stawka tworzenia.
  • Brak taryfy cache oznacza zwykłą cenę wejścia, nigdy zerowe rozliczenie.
  • Zużycie cache widać w panelu audytu oraz w Zużycie i budżet.
  • Długie prompty są rozliczane po stawce długiego kontekstu dostawcy. Gdy prompt (wraz z tokenami z cache) przekroczy próg modelu, całe wywołanie jest rozliczane po tej stawce. Widać ją pod ceną w tabeli Modele.

Na kluczu zarządzanym przez Sluis żądanie jest odrzucane z 400, zanim cokolwiek zostanie wysłane, gdy wybiera dopłatę, której Sluis nie potrafi zmierzyć:

  • cache_control z ttl innym niż 5m, tam gdzie dostawca go respektuje (Anthropic, Bedrock, Claude na Vertex)
  • service_tier inny niż auto, default, flex lub standard_only
  • beta długiego kontekstu Anthropic (context-1m) na modelu, dla którego Sluis nie ma stawki długiego kontekstu

Twój własny klucz dostawcy przekazuje wszystkie trzy bez zmian.

Kody błędów

Błędy używają koperty błędów OpenAI; wartość error.type odzwierciedla status HTTP, więc obsługa błędów w Twoim SDK działa bez zmian.

KodKiedy
400 invalid_request_errorNieprawidłowe body żądania lub parametry.
400 invalid_request_errorIdentyfikator modelu bez prefiksu dostawcy. Każdy wywoływalny identyfikator to provider/model, na przykład mistral/mistral-large-latest. Komunikat brzmi: model must be provider-prefixed.
400 invalid_request_errorŻądanie niesie usunięty nagłówek x-sluis-dlp. Nadpisania per żądanie zastąpiono nadpisaniami opcji workloadu: skonfiguruj je w Konsola › Workloady.
401 authentication_errorBrakujący lub nieznany klucz API.
402 insufficient_quotaBrak aktywnego planu lub osiągnięty budżet. Aktywuj plan albo podnieś budżet. Żądanie nigdy nie dociera do dostawcy.
403 permission_errorKlucz nie ma uprawnień, na przykład model nie jest na liście dozwolonych modeli workloadu.
422 invalid_request_errorOdrzucone przed wysyłką, na przykład ochrona danych w trybie block dopasowała żądanie.
422 document_too_large_to_scanDokument jest zbyt duży dla obranej ścieżki: strona wciąż przekracza limit pikseli renderowania przy minimalnej rozdzielczości skanowania albo plik przekracza limit bajtów ekstrakcji tekstu. Strony wielkoformatowe (rysunki A0 i A1) są automatycznie pomniejszane. Zmniejsz lub podziel dokument i wyślij ponownie.
429 rate_limit_errorOsiągnięty limit zapytań. Egzekwowany na gatewayu, więc żądanie nigdy nie dociera do dostawcy.
403 permission_errorZablokowane przez politykę rezydencji: żadna dozwolona jurysdykcja nie obsłuży żądania. Body zawiera powód.
403 scope_violationOdrzucone przez strażnika zakresu workloadu w trybie block: wywołanie wykracza poza zakres zapisany dla tego workloadu. Komunikat podaje powód strażnika, a żądanie nigdy nie trafia do dostawcy.
422 malware_detectedPrzesłany plik pasuje do sygnatury złośliwego oprogramowania i został odrzucony przed zapisaniem lub przetworzeniem. Nazwa sygnatury nigdy nie jest zwracana.
503 pdf_renderer_unavailableOsadzony PDF musiał zostać wysłany jako obrazy stron, ponieważ wybrany model przyjmuje dane obrazowe, ale to wdrożenie nie ma renderera PDF. Żądanie jest odrzucane zamiast obsłużone na podstawie wyodrębnionego tekstu, co odrzuciłoby wszystko, co pokazuje rysunek lub skan.
503 malware_scan_unavailableNie udało się sprawdzić przesłanego pliku pod kątem złośliwego oprogramowania (skaner niedostępny lub wolny albo plik przekracza limit skanowania 100 MiB), więc nie został przyjęty. Nic nie zapisano. Ponów z backoffem.
503 scope_guard_unavailableStrażnik zakresu workloadu działa w trybie block, ale nie wydał werdyktu, więc wywołanie jest odrzucane zamiast przepuszczone. Ponów z rosnącym odstępem (backoff).
503 auth_unavailableGateway nie mógł odczytać swojego magazynu kluczy, więc nie mógł zweryfikować klucza. Nie wiadomo, czy klucz jest nieprawidłowy. Ponów z backoffem i respektuj Retry-After.
504 api_errorDostawca nie odpowiedział w czasie oczekiwania na odpowiedź ustawionym dla workloadu: domyślnie 300 sekund, od 10 do 600, jeśli ustawi to workload, krócej, jeśli żądanie wysłało x-sluis-upstream-timeout. error.sluis.cause ma wartość timeout. Gateway nie powtórzył wywołania, bo dostawca może je nadal przetwarzać. Skróć prompt albo poproś o dłuższy czas, zanim wyślesz je ponownie.
5xx api_errorAwaria dostawcy nadrzędnego po ponowieniach. Bezpiecznik kieruje ruch z pominięciem niesprawnych dostawców. Body niesie komunikat samego dostawcy oraz obiekt error.sluis wskazujący przyczynę i każdą próbę, z jej statusem nadrzędnym lub błędem transportu i czasem trwania.
{
  "error": {
    "message": "model must be provider-prefixed, e.g. \"mistral/mistral-large-latest\"",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request"
  }
}

Anthropic Messages API

Sluis natywnie obsługuje API Anthropic Messages. Skieruj Claude Code lub dowolne SDK Anthropic na gateway i wywołaj POST /v1/messages. /anthropic/v1/messages to jednoznaczna ścieżka z prefiksem do tego samego handlera.

Żądanie jest tłumaczone na kształt wewnętrzny, przechodzi ten sam potok Inspect, Route, Seal i Meter co każde inne wywołanie i wraca w formacie Anthropic, wraz ze streamingiem.

Uwierzytelnianie

  • Wyślij klucz Sluis w nagłówku Anthropic x-api-key albo w zwykłym nagłówku Authorization: Bearer. Oba są akceptowane.
  • Nagłówek anthropic-version jest akceptowany z dowolną wartością i nigdy nie jest wymagany. Na GET /v1/models jego obecność wybiera format Anthropic.
  • Parsowanie jest celowo otwarte: nieznane pola body, nieznane typy bloków treści, nieznane wartości anthropic-beta oraz zapytanie ?beta=true wysyłane przez Claude Code są tolerowane, nie odrzucane.
  • Flagi beta trafiają bajt w bajt do usług nadrzędnych z rodziny Anthropic i są ignorowane wszędzie indziej.

Endpointy

EndpointPrzeznaczenie
POST /v1/messagesMessages, buforowane lub strumieniowe. Obsługuje prompty systemowe (string lub bloki), narzędzia i wyniki narzędzi (w tym wyniki błędów i obrazy w nich), obrazy, bloki dokumentów, bloki thinking i redacted_thinking w historii oraz znaczniki cache_control na każdej pozycji, którą można cache'ować.
POST /v1/messages/count_tokensLokalne oszacowanie tokenów dla zarządzania kontekstem SDK. Nic nie jest wysyłane, zatrzymywane ani mierzone.
GET /v1/models · GET /v1/models/{id}Natywne odkrywanie modeli w formacie Anthropic, z katalogu w procesie. Na ścieżce głównej format wybiera nagłówek anthropic-version, a bez niego dostajesz format OpenAI. Pod /anthropic obowiązuje zawsze. Kursory before_id, after_id i limit działają w miarę możliwości, a created_at to stały zapychacz, bo katalog nie ma daty wydania dla poszczególnych modeli.
HEAD /api/helloSonda rozgrzewkowa wysyłana przez Claude Code przed sesją: tylko HEAD, odpowiedź 200 z pustym ciałem.

Routing modeli

Format przewodowy nigdy nie ogranicza modelu: wejście jest kodekiem, a trasę wyznacza identyfikator modelu.

  • Goły identyfikator, taki jak claude-sonnet-5, jest rozwiązywany przez domyślnego dostawcę tego wejścia, anthropic, chyba że organizacja wskaże innego (na przykład vertex dla Claude hostowanego w UE). Bramka rezydencji nadal decyduje, czy ten cel może obsłużyć żądanie.
  • Przypnij cel jawnie identyfikatorem z prefiksem dostawcy, takim jak vertex/claude-opus-4-8.
  • Albo przekaż alias sluis/*. Narzędzie z SDK Anthropic działa wtedy na dowolnym podłączonym dostawcy, w ramach Twojej polityki.

Streaming

Z "stream": true odpowiedź ma pełną gramatykę zdarzeń Anthropic:

  • message_start, potem content_block_start, content_block_delta i content_block_stop dla każdego bloku, potem message_delta ze skumulowanym zużyciem (w tym tokenami odczytu i tworzenia cache), potem message_stop.
  • Tekst przychodzi jako text_delta, argumenty narzędzi jako input_json_delta, a rozumowanie jako thinking_delta plus signature_delta, gdy wyznaczony dostawca je wygenerował.
  • message_start niesie liczbę tokenów wejściowych, gdy dostawca raportuje ją w pierwszym fragmencie. W przeciwnym razie zaczyna od zera, a message_delta raportuje zaktualizowane zużycie.
  • Zdarzenie ping następuje po message_start i powtarza się po mniej więcej 15 sekundach ciszy z usługi nadrzędnej, więc długa tura myślenia nigdy nie uruchomi watchdoga klienta.
  • Awaria w trakcie strumienia jest ponownie kodowana jako zdarzenie error zamiast urwanego strumienia.
  • stop_sequence niesie dopasowaną sekwencję, gdy odpowiedź pochodziła od dostawcy z rodziny Anthropic, a w przeciwnym razie jest null.
  • Wyślij x-sluis-include-cost: true, a zużycie w message_delta zawiera też sluis_cost_eur, cenę wywołania dla Twojej organizacji w EUR, oraz sluis_cost_estimated: true tylko przy szacunku. Zobacz Koszt wywołania.
# native Anthropic Messages: the model id owns the route, not the wire format
curl https://api.sluis.ai/v1/messages \
  -H "x-api-key: $SLUIS_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{ "model": "vertex/claude-opus-4-8",
        "max_tokens": 256,
        "system": "Be concise.",
        "messages": [{ "role": "user", "content": "Say hi" }] }'

# /anthropic/v1/messages is the unambiguous prefixed path for the same handler

Błędy

Błędy z handlerów Messages używają koperty Anthropic: najwyższego poziomu "type": "error" z typem błędu dostawcy. Dotyczy to też odmów, które nigdy nie docierają do modelu, takich jak nieznany klucz czy blokada ochrony danych.

Typy błędów dostawcy to invalid_request_error, authentication_error, billing_error, permission_error, not_found_error, conflict_error, request_too_large, rate_limit_error, api_error i overloaded_error.

  • Odpowiedź niesie nagłówek request-id i pole body request_id, czyli identyfikator korelacji dla Twojego klienta.
  • Gdy wywołanie wytworzyło wiersz audytu, nagłówek x-sluis-request-id identyfikuje ten wiersz. Błąd uwierzytelnienia nie ma wiersza audytu.
  • Odpowiedzi HTTP 5xx obsługiwane przez gateway mają też osobny diagnostyczny x-request-id. Bezpieczny identyfikator klienta jest zwracany również w innych odpowiedziach. Gwarancja nie obejmuje błędów proxy przed gatewayem.
  • Odmowy na poziomie gatewaya, które zdarzają się przed handlerem, takie jak backpressure rejestru lub przeciążenie, mogą wrócić w formacie błędu OpenAI.
# failures from the Messages handlers are Anthropic-shaped: auth and
# data-protection refusals included
{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "rate limit exceeded"
  },
  "request_id": "req_9f2e…"
}

Niepusta tablica mcp_servers jest odrzucana z 400 invalid_request_error zamiast przekazana dalej. Model wywołujący zewnętrzny serwer MCP samodzielnie znalazłby się poza bramką Sluis. Zarejestruj serwer w Konsoli i wywołuj jego narzędzia przez gateway MCP, gdzie każde wykonane wywołanie narzędzia jest sprawdzane, routowane, pieczętowane i mierzone.

Macierz zgodności

Co natywne wejścia obejmują dziś, endpoint po endpoincie. Ta tabela jest deklaracją: czego nie ma tu jako obsługiwane, jest na roadmapie, świadomie odrzucane albo należy do innej powierzchni produktu, nigdy nie jest sugerowane po cichu.

AnthropicStatusUwagi
POST /v1/messages✓ natywneBuforowane i strumieniowe, narzędzia, obrazy, bloki dokumentów, round-trip thinking i znaczniki cache promptów.
POST /v1/messages/count_tokens✓ lokalne oszacowanieObsługiwane lokalnie. Nic nie jest wysyłane.
GET /v1/models · /v1/models/{id}✓ natywneNatywny format list i get z katalogu w procesie. Na ścieżce głównej negocjowany nagłówkiem, pod /anthropic bezwarunkowy.
HEAD /api/hello✓Sonda rozgrzewkowa Claude Code, tylko HEAD.
Message Batches✓ opcjonalneDostępne, gdy wdrożenie je włącza: create, list, get, results i cancel, dla modeli rozwiązywanych do Anthropic. W przeciwnym razie 404. Dla innych dostawców użyj /v1/batches w formacie OpenAI.
Files✗ w planachFiles API nie jest mostkowane. Osadzone bloki dokumentów i file_data pokrywają typową ścieżkę.
mcp_servers✗ odrzucaneNiepusta tablica jest odrzucana z 400 zamiast przekazana dalej. Zarejestruj serwer i użyj gatewaya MCP Sluis.
Skills · Agents · Admin✗ poza zakresemSkills, agenci zarządzani oraz API administracyjne, użycia i kosztów to inna powierzchnia produktu, nie zgodność inferencji.

Routing między protokołami

Pola specyficzne dla dostawcy przetrwają, dopóki żądanie trafia do dostawcy mówiącego tym samym protokołem. Żądanie Anthropic obsłużone przez dostawcę z rodziny Anthropic zachowuje bloki thinking, znaczniki cache, flagi beta i dopasowane stop_sequence.

Przy routingu między protokołami te pola są odrzucane przy wysyłce, nigdy przy wejściu. Wiersz audytu zapisuje zarówno format przewodowy, jak i rozwiązanego dostawcę, więc każde pogorszenie da się przypisać.

Nieprzezroczyste wartości nigdy nie są przepisywane: podpisy thinking i ładunki redacted_thinking są przekazywane dosłownie albo wcale. Dlatego zaparkowany blok thinking oznaczony przez skan ochrony danych jest usuwany, a nie maskowany: przepisany blok niósłby nieprawidłowy podpis.