API TypeSafe

Punkt końcowy oceny HTTP

Treść żądania ma trzy pola najwyższego poziomu. state jest wymagane i może być ciągiem znaków, obiektem lub tablicą tekstów. model jest wymagane; przykłady w dokumentacji używają jev-latest. questions to mapa typowanych obiektów Question. Każdy klucz wybierasz samodzielnie. Odpowiednia odpowiedź wraca pod tym samym identyfikatorem. Klucz nie jest wysyłany do modelu bazowego ani używany podczas inferencji.

Minimalny obiekt Noul wygląda tak: {"state": "Pomocy! Moje wypłaty nie działają od 3 dni.", "model": "jev-latest", "questions": {"is_urgent": {"type": "noul", "instructions": "Czy ta wiadomość wyraża pilność?"}}}. Choice dodaje mapę kryteriów przypisującą nazwy opcji do opisów. Score dodaje uporządkowaną tablicę kryteriów poziomów. Wszystkie trzy mają wspólne pola type i instructions, a każde dodaje kryteria we własnym formacie.

Pobierz klucz API z https://console.typesafe.ai/settings/keys. Jeśli wywołujesz HTTP bezpośrednio, obsłuż 429 zgodnie z retry-after. Limity dla Jev 1.13 wynoszą 250,000 tokenów na sekundę i 1,200 żądań na minutę; mogą ulec zmianie bez uprzedzenia. SDK domyślnie ponawiają żądania z rosnącym opóźnieniem. Listę modeli pobierzesz przez GET /v1/models z tym samym tokenem Bearer.

Oficjalne SDK

Python: pip install typesafe-sdk. Zaimportuj TypeSafeClient z typesafe_sdk. Użyj TypeSafeClient() jako klienta: client.system_one(state, questions). Konstruktory takie jak Noul, Choice i Score są dostępne w pakiecie, więc nie musisz ręcznie wpisywać pola typu JSON. Domyślny model to jev-latest. Wymagany jest Python 3.10 lub nowszy.

JavaScript: npm install @typesafe-ai/sdk. Zaimportuj { TypeSafeClient } z "@typesafe-ai/sdk". Klient łączy się z tym samym punktem końcowym. Wymagane środowisko uruchomieniowe to Node.js 20+. Repozytorium: https://github.com/typesafe-ai/typesafe-sdk-js. Oba zestawy SDK udostępniają models.list() z katalogiem aliasów.

Playground pod adresem https://console.typesafe.ai/playground jest konsolą wymagającą logowania, a nie publicznym elementem do osadzenia. Wklej tekst jako state, dodaj Noul, np. „Czy ta wiadomość wyraża pilność?”, a następnie umieść więcej pytań w jednym wywołaniu. To najszybszy sposób, by sprawdzić równoległą ocenę przed podłączeniem kluczy produkcyjnych.

Pierwsze wywołanie curl

curl -X POST https://api.typesafe.ai/v1/systemone z nagłówkami Authorization: Bearer $TYPESAFE_API_KEY i Content-Type: application/json. Treść: state z komunikatem o błędzie Stripe Connect, model jev-latest oraz questions.urgency typu noul z instrukcją „Czy ta wiadomość wyraża pilność?”. To przykład szybkiego startu. Bez dodatkowego żądania dodaj Choice o nazwie department z kryteriami billing / technical / sales oraz Score o nazwie frustration z uporządkowanymi poziomami.

Gdy coś zawiedzie, przeczytaj jaggedness, zanim rozbudujesz instrukcje. Odczyt dosłowny wymaga dokładnego warunku w instrukcjach i kryteriach. Obliczenia należy wykonywać w kodzie. Generowanie wymaga innego modelu. API nadal zwróci typowany ładunek, jeśli przez połączone Choice poprosisz Jev o napisanie akapitu, ale wynik będzie powolny i słaby. Użyj wyrażenia regularnego lub modelu generatywnego do zaproponowania opcji, a potem pozwól Jev wybrać.

Cloudflare Workers AI podaje typesafe/jev jako nazwę katalogową. To wpis zewnętrznego dostawcy, a nie zamiennik api.typesafe.ai. Na Steam nie ma aplikacji Jev. Przechowuj klucze w konsoli TypeSafe, a społecznościowe SDK z Awesome Jev uznawaj za nieoficjalne, chyba że śledzą organizację github.com/typesafe-ai.

Błędy, ponawianie i identyfikatory

429 Too Many Requests to udokumentowana odpowiedź po przekroczeniu limitu tokenów na sekundę lub żądań na minutę. Przestrzegaj retry-after. Oficjalne SDK już stosują rosnące opóźnienia. Jeśli samodzielnie obsługujesz HTTP, nie zasypuj punktu końcowego żądaniami po błędzie 429 — nadal będziesz w tym samym oknie limitu.

Identyfikatory pytań służą do śledzenia wywołań. Nigdy nie trafiają do inferencji. Możesz wygenerować w pętli item_0 aż do item_n i nadal otrzymać po jednym Noul. Klucze w obrębie żądania muszą być unikatowe. Ponowne użycie klucza bez ostrzeżenia nadpisze pytanie w mapie.

Autoryzacja korzysta z klucza API Bearer TypeSafe pobranego z panelu. api.typesafe.ai nie używa sesji opartej na plikach cookie. Klucze zmieniaj w konsoli, zamiast pisać do tej wiki. Ekran logowania do playgroundu jest osobny: to konsola przeglądarkowa, a nie alternatywne API HTTP.

Skopiuj raz polecenie curl z szybkiego startu, a potem usuń je z repozytorium i przejdź na SDK. SDK obsługuje ponawianie i konstruktory typowane. Czyste HTTP jest przeznaczone dla języków bez oficjalnego klienta. W obu przypadkach klucze Bearer i ta sama treść JSON trafiają do POST /v1/systemone.

GET /v1/models zwraca aliasy, których może używać Twoje konto. Lista może nie zawierać jev-1.13.0, mimo że ten identyfikator działa w POST /v1/systemone. Nie traktuj jej jako listy dozwolonych identyfikatorów wersjonowanych. To katalog aliasów; identyfikator wersjonowany przechowuj we własnej konfiguracji.

Nigdy nie zatwierdzaj TYPESAFE_API_KEY w repozytorium. Jeśli wycieknie, zmień go w panelu. contact@jevai.wiki to niewłaściwy adres do zgłaszania wycieku sekretu — użyj własnych kanałów TypeSafe.

Python 3.10 i Node.js 20 to udokumentowane wersje minimalne. Starsze środowiska nie są obsługiwane przez oficjalne klienty.