Dokumentácia pre vývojárov

HiFay API & Oficiálna knižnica

Integrujte necenzurovanú a rýchlu inteligenciu do vašich systémov za pár minút. K dispozícii je oficiálny Python balík aj štandardné REST volania.

1. Python knižnica (odporúčané)

Nainštalujte oficiálnu knižnicu jednoducho cez pip:

pip install hifay

Použitie v kóde:

import hifay

client = hifay.Client(api_key="hf-...")   # predvolené: chat.hifay.co
odpoved = client.chat("Ahoj!")
print(odpoved)

2. Priamo cez HTTP (curl), pre iné jazyky

Štandardný POST request na endpoint s odpoveďou v poli response:

curl "https://chat.hifay.co/api.php?action=v1_chat" \
  -H "Authorization: Bearer hf-..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Ahoj"}'

Odpoveď v JSON formáte:

{
  "success": true,
  "response": "Ahoj! Ako vám môžem dnes pomôcť?",
  "model": "hifay-entity-1",
  "usage": { "prompt_chars": 4, "response_chars": 34 }
}

Pracujete pre firmu, ktorá má HiFay na vlastnom serveri?

Rovnaká dokumentácia s presnou adresou vášho servera je priamo v aplikácii firmy, v Nastaveniach, v záložke „API".

V Python knižnici stačí zadať vlastnú adresu: client = hifay.Client(api_key="hf-...", base_url="https://vas-firemny-server.local")

Získanie kľúča

Prihláste sa do HiFay a otvorte Nastavenia → API pripojenia. Zadajte názov kľúča a stlačte Vytvoriť kľúč. Všetky kľúče sa začínajú prefixom hf-.

Kľúč sa zobrazí len raz. Ukladáme si z neho iba kryptografický odtlačok. Ak ho stratíte, vytvorte nový a starý deaktivujte.

Autentifikácia

Kľúč môžete poslať buď v Authorization: Bearer alebo x-api-key:

Authorization: Bearer hf-98a72b...
x-api-key: hf-98a72b...

Endpointy a parametre

POSThttps://chat.hifay.co/v1/chat alebo api.php?action=v1_chat

PolePovinnéPopis
promptáno* Text otázky alebo zadania.
messagesáno* Pole histórie konverzácie s rolami user a assistant.
systemnie Systémová inštrukcia (osobnosť asistenta, formátovanie výstupu).
streamnie true pre streaming textu po tokenoch cez Server-Sent Events.

Príklady v ďalších jazykoch

curl "https://chat.hifay.co/api.php?action=v1_chat" \
  -H "Authorization: Bearer $HIFAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Vytvor analýzu trhu"}'
Potrebujete pomoc s integráciou alebo vlastný firemný endpoint? Kontaktujte náš tím.