Dokumentácia

AIHook API — tri vrstvy AI integrácie: OpenAI-kompatibilná, natívna s RAG, a OCR extrakcia dokumentov.

Rýchly štart

Ak používaš OpenAI SDK, stačí zmeniť base_url a api_key:

# Python
from openai import OpenAI

client = OpenAI(
    api_key="sk-msai-váš-kľúč",
    base_url="https://api.aihook.eu/v1"
)

response = client.chat.completions.create(
    model="aihook/veterina",
    messages=[{"role": "user", "content": "Dávka amoxicilínu pre mačku 4kg?"}]
)
print(response.choices[0].message.content)

Autentifikácia

Každý request musí obsahovať API kľúč v hlavičke Authorization:

Authorization: Bearer sk-msai-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Open WebUI integrácia

AIHook je plne kompatibilné s Open WebUI — self-hosted chat rozhranie s 146k+ hviezdičkami. Zákazník dostane plnohodnotný AI chat bez vývoja.

Po pripojení sa všetky AIHook modely (tiery + kódovacie) zobrazia v dropdowne Open WebUI automaticky cez GET /v1/models.

POST /v1/chat/completions

OpenAI-kompatibilný endpoint. Funguje s akýmkoľvek OpenAI SDK, Cursor, VS Code, Open WebUI a ďalšími nástrojmi bez zmeny kódu.

Request body

Parameter	Typ	Popis
model	string	required Tier model (aihook/veterina) alebo kódovací model (aihook/deepseek-v3)
messages	array	required Pole správ [{role, content}], max 50
stream	boolean	optional Streaming (default: false)

POST /v1/chat

AIHook natívny endpoint s plnou podporou RAG, zdrojov a jazykového nastavenia.

Request body

Parameter	Typ	Popis
category	string	required veterina, medicina, kod, ocr, preklad, analyza, podpora
messages	array	required Pole správ [{role, content}], max 50
kb	boolean	optional Zapnúť RAG (default: podľa kategórie)
kb_results	integer	optional Počet KB výsledkov (1–20, default: 5)
language	string	optional Jazyk odpovede: sk, cs, en, de

POST /v1/ocr

Extrakcia textu alebo štruktúrovaných dát zo súborov. Vstup: multipart/form-data.

Parametre

Parameter	Typ	Popis
file	file	required PDF, JPEG, PNG, WEBP, TIFF — max 20 MB
model	string	optional aihook/ocr-basic (default), aihook/ocr-pro, aihook/ocr-expert
type	string	optional document (default), invoice, receipt, custom
language	string	optional Jazyk dokumentu (default: sk)
schema	string	optional JSON schema pre type=custom

Príklad — faktúra

curl -X POST https://api.aihook.eu/v1/ocr \
  -H "Authorization: Bearer sk-msai-..." \
  -F "file=@faktura.pdf" \
  -F "model=aihook/ocr-pro" \
  -F "type=invoice"

Odpoveď — invoice

{
  "id": "ocr-a1b2c3d4e5f6",
  "model": "aihook/ocr-pro",
  "type": "invoice",
  "data": {
    "invoice_number": "2026001",
    "issue_date": "2026-07-01",
    "supplier": { "name": "Firma s.r.o.", "iban": "SK12 1234..." },
    "total": 120.00,
    "vat_amount": 20.00,
    "currency": "EUR"
  },
  "cost_eur": 0.00082
}

GET /v1/models

Zoznam všetkých dostupných modelov. Verejný endpoint — nevyžaduje autentifikáciu.

POST /v1/kb/search

Priame vyhľadávanie v znalostnej báze bez volania AI modelu.

GET /v1/usage

Spotreba tokenov a náklady za zvolené obdobie.

GET /v1/status

Health check. Verejný endpoint.

Tier modely

Modely sú abstrahované do tierov — skutočný model za nimi sa môže zmeniť bez toho aby zákazník menil kód.

Model ID	Kategória	RAG	Cena / 1k tokenov
aihook/faktura	ocr	—	€0.010
aihook/medicina	medicina	—	€0.010
aihook/veterina	veterina	✓ VetBase	€0.008
aihook/veterina-research	veterina	✓ VetBase	€0.018
aihook/medicina-basic	medicina	✓ PharmaBase	€0.004
aihook/medicina-pro	medicina	✓ PharmaBase	€0.008
aihook/medicina-expert	medicina	✓ PharmaBase	€0.018
aihook/ocr-basic	ocr	—	€0.005
aihook/ocr-pro	ocr	—	€0.010
aihook/ocr-expert	ocr	—	€0.020
aihook/preklad-basic	preklad	—	€0.002
aihook/preklad-pro	preklad	—	€0.006
aihook/preklad-expert	preklad	—	€0.016
aihook/analyza-basic	analyza	—	€0.002
aihook/analyza-pro	analyza	—	€0.006
aihook/analyza-expert	analyza	—	€0.016
aihook/podpora-basic	podpora	✓ TenantDocs	€0.003
aihook/podpora-pro	podpora	✓ TenantDocs	€0.007
aihook/podpora-expert	podpora	✓ TenantDocs	€0.018

Kódovacie modely

Pre programovanie sú dostupné reálne názvy modelov — developeri si vyberú podľa vlastných preferencií a benchmarkov.

Model ID	Názov	Kontext	Cena / 1k tokenov
aihook/gpt-4o	GPT-4o	128k	€0.002
aihook/gpt-4o-mini	GPT-4o Mini	128k	€0.000
aihook/gpt-4.1	GPT-4.1	1047k	€0.002
aihook/gpt-4.1-mini	GPT-4.1 Mini	1047k	€0.000
aihook/o4-mini	o4-mini (reasoning)	200k	€0.001
aihook/claude-haiku-4	Claude Haiku 4.5	200k	€0.001
aihook/claude-sonnet-5	Claude Sonnet 5	200k	€0.003
aihook/claude-opus-5	Claude Opus 5	200k	€0.014
aihook/gemini-2.5-flash	Gemini 2.5 Flash	1048k	€0.000
aihook/gemini-2.5-pro	Gemini 2.5 Pro	1048k	€0.001
aihook/deepseek-v3	DeepSeek V3	64k	€0.000
aihook/deepseek-r1	DeepSeek R1 (reasoning)	64k	€0.000
aihook/qwen3-235b	Qwen3 235B	40k	€0.000
aihook/qwen3-30b	Qwen3 30B	40k	€0.000
aihook/coder-qwen-32b	Qwen 2.5 Coder 32B	32k	€0.000
aihook/llama-4-maverick	Llama 4 Maverick	1000k	€0.000
aihook/llama-3.3-70b	Llama 3.3 70B	128k	€0.000
aihook/mistral-large	Mistral Large	128k	€0.002
aihook/mistral-small	Mistral Small	32k	€0.000

RAG — znalostná báza

RAG (Retrieval-Augmented Generation) umožňuje AI odpovedať na základe overených zdrojov.

• VetBase — 70 000+ veterinárnych článkov z PubMed/PMC (dostupné pre veterina tiery)
• PharmaBase — medicínska báza (dostupná pre medicina tiery)

Tiery expert vyhľadávajú až 15 článkov pre maximálny kontext. Tiery basic používajú 3 články pre rýchlu odpoveď.

Chybové kódy

HTTP	Kód	Popis
401	invalid_api_key	Neplatný alebo chýbajúci API kľúč
402	insufficient_balance	Nedostatočný kredit
403	kb_access_denied	Prístup k znalostnej báze nie je povolený
404	model_not_found	Neznámy model
405	method_not_allowed	Nesprávna HTTP metóda
413	file_too_large	Súbor väčší ako 20 MB
422	validation_failed	Neplatné vstupné parametre
429	rate_limit_exceeded	Príliš veľa requestov — pozri Retry-After header
503	ai_service_error	Chyba komunikácie s AI modelom