Dokumentacja - OmniCog AI

1. API REST

Backend OmniCog AI oparty jest na frameworku FastAPI (Python). API udostepnia endpointy REST do zarzadzania zadaniami, ustawieniami i rozliczeniami.

Bazowy URL

https://ai-best.pl/

Autoryzacja

Kazde zapytanie wymaga uwierzytelnienia za pomoca jednej z dwoch metod:

Session cookie - automatycznie ustawiany po zalogowaniu w przegladarce
Naglowek X-User-Id - identyfikator uzytkownika przekazywany w naglowku HTTP

2. Glowne endpointy

Metoda	Endpoint	Opis
POST	/tasks	Tworzenie nowego zadania AI
GET	/tasks/{id}	Pobranie szczegulow zadania
GET	/tasks/{id}/stream	Strumien SSE z wynikami zadania
POST	/tasks/{id}/cancel	Anulowanie trwajacego zadania
GET	/settings/runtime	Pobranie ustawien runtime
GET	/usage	Statystyki zuzycia kredytow
GET	/plans	Lista dostepnych planow

3. SSE Events

Endpoint /tasks/{id}/stream zwraca strumien Server-Sent Events (SSE). Kazde zdarzenie zawiera pole event i data w formacie JSON.

token - kolejny fragment tekstu odpowiedzi (streaming tokenow)
tool - wywolanie narzedzia przez model AI
status - zmiana statusu zadania (np. running, completed, failed)
progress - informacja o postepie wykonywania zadania
plan - plan dzialania wygenerowany przez model
trace - dane diagnostyczne i logi wewnetrzne
done - zakonczenie strumienia, zadanie zostalo ukonczone

4. Modele

Platforma OmniCog AI udostepnia nastepujace modele AI:

Multi Machine - wewnetrzny model laczacy wiele dostawcow AI w jednym zapytaniu
Qwen 14B - otwarty model jezykowy Qwen 14 miliardow parametrow
GPT-4o - multimodalny model OpenAI czwartej generacji
GPT-5.4 Auto - najnowszy model OpenAI z automatycznym doborem parametrow
Web Agent - agent przegladajacy internet i pobierajacy informacje ze stron
Report Machine - model zoptymalizowany do generowania raportow i analiz
Analysis Machine - model do zaawansowanej analizy danych i dokumentow

5. Plugin VS Code (Codex)

OmniCog AI oferuje rozszerzenie do Visual Studio Code o nazwie Codex, ktore umozliwia korzystanie z modeli AI bezposrednio z poziomu edytora kodu.

Glowne funkcje

Generowanie kodu na podstawie opisu w jezyku naturalnym
Autouzupelnianie i sugestie kodu w czasie rzeczywistym
Wyjasnianie fragmentow kodu
Refaktoryzacja i optymalizacja istniejacego kodu
Integracja z kontekstem projektu

Instalacja

Plugin dostepny jest w VS Code Marketplace. Po instalacji zaloguj sie na swoje konto OmniCog AI, aby rozpoczac prace.

6. Limity i billing

System rozliczen OmniCog AI oparty jest na kredytach. Kazdy plan posiada miesieczny limit kredytow, ktory odnawia sie na poczatku kazdego okresu rozliczeniowego.

Soft limit

Po osiagnieciu soft limitu uzytkownik otrzymuje powiadomienie o zblizaniu sie do konca kredytow. Moze kontynuowac korzystanie z platformy do momentu osiagniecia hard limitu.

Hard limit

Po osiagnieciu hard limitu zapytania do AI zostaja wstrzymane. Uzytkownik moze doladowac konto (Pay As You Go) lub poczekac na odnowienie limitu w nowym okresie rozliczeniowym.

Pay As You Go (PAYG)

Doladowania pozwalaja na zakup dodatkowych kredytow poza limitem planu. Minimalna kwota doladowania wynosi $20 USD. Kredyty z doladowan nie wygasaja.

7. Bezpieczenstwo

Platforma OmniCog AI stosuje wielowarstwowe zabezpieczenia w celu ochrony uzytkownikow i infrastruktury.

Cloudflare Turnstile

Weryfikacja uzytkownikow za pomoca Cloudflare Turnstile chroni przed botami i automatycznymi atakami. Weryfikacja jest wymagana przy logowaniu i rejestracji.

Rate limiting

System ogranicza liczbe zapytan do 2 zapytan na sekunde na uzytkownika. Po przekroczeniu 100 naruszen limitu konto zostaje tymczasowo zablokowane na 5 minut.

Secret Manager

Wszystkie klucze API, tokeny i dane wrazliwe przechowywane sa w zewnetrznym Secret Managerze. Zadne sekrety nie sa przechowywane w kodzie zrodlowym ani w bazie danych.

Dokumentacja dla deweloperow