LLM Hřiště

API Dokumentace

Kompletní dokumentace API pro LLM Hřiště. Pro použití API je vyžadován API klíč.

Autentizace
Všechny API požadavky vyžadují API klíč v hlavičce X-API-Key

Získání API klíče:

Pro získání API klíče kontaktujte [email protected]

Použití API klíče:

X-API-Key: YOUR_API_KEY
Rate Limiting
Omezení počtu požadavků na API
Limit:60 požadavků/minutu

Při překročení limitu obdržíte HTTP 429 (Too Many Requests). V hlavičkách odpovědi najdete informace o limitu:

  • X-RateLimit-Limit - maximální počet požadavků
  • X-RateLimit-Remaining - zbývající požadavky
  • X-RateLimit-Reset - čas resetu (unix timestamp)
Base URL
Production
https://hriste.sebesta.dev/api

API Endpointy

POST
/chat
Odeslat zprávu do LLM modelu a získat streamovanou odpověď

Request Body:

{
  "messages": [
    {
      "role": "user",
      "content": "Ahoj! Jak se máš?"
    }
  ],
  "model": "llama-3.3-70b-versatile",
  "language": "cs",
  "thinkingEnabled": true,
  "searchEnabled": false
}

HTTP Status Codes:

200 OK
400 Bad Request
401 Unauthorized
429 Too Many Requests
500 Internal Server Error
GET
/models
Získat seznam všech dostupných LLM modelů

Response:

{
  "models": [
    {
      "id": "llama-3.3-70b-versatile",
      "name": "Llama 3.3 70B Versatile",
      "provider": "groq",
      "context_length": 131072
    }
  ]
}

HTTP Status Codes:

200 OK
401 Unauthorized
429 Too Many Requests
POST
/questions/generate
Vygenerovat kvízové otázky z dokumentu (PDF, DOC, DOCX, PPT, PPTX, TXT)

Request (multipart/form-data):

  • file - Soubor k analýze (PDF, DOC, DOCX, PPT, PPTX, TXT, max 50MB)
  • numberOfQuestions - Počet otázek k vygenerování (1-50, výchozí: 10)

Response:

{
  "questions": [
    {
      "content": "Kdy začala první světová válka?",
      "questionType": "number",
      "correctAnswer": "1914"
    },
    {
      "content": "Které město je hlavním městem Francie?",
      "questionType": "pick",
      "correctAnswer": "Paříž",
      "wrongAnswers": [
        "Londýn",
        "Berlín",
        "Madrid"
      ]
    }
  ]
}

HTTP Status Codes:

200 OK
400 Bad Request
500 Internal Server Error

Poznámky:

  • Endpoint nevyžaduje API klíč (pouze interní použití)
  • Podporované formáty: PDF, DOC, DOCX, PPT, PPTX, TXT
  • Maximální velikost souboru: 50 MB
  • Pro PDF s obrázky se automaticky použije OCR nebo LlamaParse
Kontakt

Máte dotazy nebo potřebujete pomoc? Kontaktujte nás na [email protected]