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-.
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
| Pole | Povinné | Popis |
|---|---|---|
prompt | áno* | Text otázky alebo zadania. |
messages | áno* | Pole histórie konverzácie s rolami user a assistant. |
system | nie | Systémová inštrukcia (osobnosť asistenta, formátovanie výstupu). |
stream | nie | 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"}'
const res = await fetch('https://chat.hifay.co/api.php?action=v1_chat', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HIFAY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ prompt: 'Ahoj!' }),
});
const data = await res.json();
console.log(data.response);
import hifay
client = hifay.Client(api_key="hf-...")
response = client.chat("Ahoj! Ako sa máš?")
print(response)
<?php
$ch = curl_init('https://chat.hifay.co/api.php?action=v1_chat');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('HIFAY_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['prompt' => 'Ahoj!']),
]);
$res = json_decode(curl_exec($ch), true);
echo $res['response'] ?? $res['error'];