Dokumentacja

API i MCP.

TORIN wystawia własne API pod /v1/ oraz serwer MCP pod /mcp, żeby dało się go podpiąć do narzędzi, których już używasz, także do Claude i ChatGPT.

Zapisz się na listę Lista końcówek

Zakładanie kont od 1 grudnia 2026. Zapisz się, a napiszemy jeden raz.

APIzakresy klucza/v1/

rozmowa7 końcówek
czytaj6 końcówek
pliki3 końcówki
zuzycie2 końcówki
dowolny, dziennikpo 1 końcówce

Pierwsze wywołanie

Saldo żetonów jednym zapytaniem.

Klucz wydajesz w ustawieniach agencji i unieważniasz w każdej chwili. Nagłówek Authorization albo x-api-key.

Zapytanie

curl https://app.hiretorin.com/v1/credits \
  -H "Authorization: Bearer $TORIN_KLUCZ"

Odpowiedź (przykładowe wartości)

{
  "object": "credits",
  "balance": 240,
  "buckets": {
    "carried_over": 0,
    "plan": 240,
    "topped_up": 0
  },
  "tier": "probny",
  "period": "2026-11",
  "included_in_tier": 2000,
  "renews_on": "2026-12-01",
  "grosz_per_credit": 1,
  "low": false,
  "note": "Zostało 240 żetonów (wartość 2,40 zł)."
}

Policzone z produktu 2 listopada 202613 pól odpowiedzi

Claude i ChatGPT

Serwer MCP.

Zmiana na koncie klienta przez API i MCP powstaje jako propozycja, nie jako wykonanie: obowiązują te same zgody co w aplikacji.

Adres serwera MCP:  https://app.hiretorin.com/mcp
Logowanie:          OAuth (konektor sam znajdzie serwer
                    autoryzacji pod /.well-known/)
Zakres:             czytaj; narzędzia zmian tworzą propozycje

Końcówki

Co udostępnia API.

Torin łączy przewody na pulpicie łącznicy

Metoda	Adres	Zakres klucza	Co robi
`GET`	`/v1/models`	`dowolny`	modele, które da się zamówić
`GET`	`/v1/credits`	`zuzycie`	stan żetonów agencji
`GET`	`/v1/usage`	`zuzycie`	zużycie w okresie
`POST`	`/v1/chat/completions`	`rozmowa`	pytanie w formacie zgodnym z OpenAI
`POST`	`/v1/messages`	`rozmowa`	pytanie w formacie zgodnym z Anthropic
`POST`	`/mcp`	`czytaj`	serwer MCP (narzędzia odczytu)
`GET`	`/v1/threads`	`czytaj`	rozmowy agencji
`GET`	`/v1/threads/{id}`	`czytaj`	jedna rozmowa
`POST`	`/v1/threads`	`rozmowa`	nowa rozmowa
`POST`	`/v1/threads/{id}/messages`	`rozmowa`	wiadomość w rozmowie
`GET`	`/v1/runs`	`czytaj`	przebiegi pracy
`GET`	`/v1/runs/{id}`	`czytaj`	jeden przebieg
`POST`	`/v1/runs`	`rozmowa`	zlecenie pracy w tle
`POST`	`/v1/runs/{id}/decyzja`	`rozmowa`	decyzja w przebiegu, który na nią czeka
`POST`	`/v1/runs/{id}/anuluj`	`rozmowa`	przerwanie przebiegu
`GET`	`/v1/tools`	`czytaj`	narzędzia i to, które wymagają zgody
`GET`	`/v1/files`	`pliki`	pliki z rozmów
`GET`	`/v1/files/{id}`	`pliki`	jeden plik
`POST`	`/v1/files/{id}/link`	`pliki`	link do pliku na kwadrans
`GET`	`/v1/audit`	`dziennik`	dziennik zdarzeń agencji

Policzone z produktu 2 listopada 202620 końcówek

Testy

Jak to sprawdzamy.

Każdy moduł ma własny zestaw testów offline. Pełny przebieg idzie z zablokowanym wyjściem do sieci, więc żaden test nie zależy od cudzego API.

264: zestawy
361 540: sprawdzeń
0: prób wyjścia do sieci

Policzone z produktu 31 października 2026ostatni pełny przebieg, zielony

Sprawdź go na koncie jednego klienta.

Bez karty i bez hasła. Pakiet próbny to 20 zł netto na pracę Torina.

Zapisz się na listę Zobacz cennik

Torin w drzwiach biura podaje identyfikator na niebieskiej smyczy