# BACALAURESCU API - Commands Manual

Folosește `/api/v1/ai/man/{cmd}` pentru detalii complete despre fiecare comandă.

Rate limit (anonymous): 60 req/min, 5000 req/day

## literatura

- **/opera** [slug]: Date despre o operă literară din programa BAC (sau lista completă)
- **/autor** [slug]: Biografie autor + lista operelor sale
- **/personaj** [slug]: Profil personaj cu stats RPG (inteligență, curaj, charisma...)
- **/comentariu** <slug>: Comentariu literar complet pentru BAC
- **/incipit** <slug>: Începutul (primele rânduri) ale unei opere
- **/rezumat** <slug>: Rezumat scurt al unei opere
- **/moment** <slug> [index]: Moment narativ specific al unei opere (sau lista completă)
- **/tema** [tema]: Caută o temă literară și operele care o conțin
- **/curent** [slug]: Curent literar (Romantism, Realism, Modernism etc.)
- **/locatie** <slug>: Locație din operă (descriere, atmosferă, semnificație)
- **/relatii** <slug>: Toate relațiile dintre personaje într-o operă
- **/citat** [slug]: Citat literar (random sau filtrat pe autor)
- **/curiozitate** [slug]: Curiozitate literară (fun fact)
- **/cauta** <query>: Căutare cross-content (autori, opere, personaje)

## joc

- **/quiz** [slug]: Întrebare quiz random (sau pe o operă specifică)
- **/daily** : Provocarea zilei (adevărat/fals despre literatură)
- **/random** : Surprinde-mă: orice tip de conținut, aleatoriu

## media

- **/film** <slug>: Film animat al unei opere (Veo 3.1 / del Toro style)
- **/podcast** [slug]: Episod podcast Bacalaurescu Show (Caragiale + invitați)
- **/muzica** [slug]: Melodii ale unui autor (sau lista completă)

## bac

- **/istoric** [year]: Istoric subiecte BAC Limba Română 2000-2025
- **/calendar** : Calendar BAC 2026 (datele examenelor)
- **/timer** : Câte zile mai sunt până la BAC 2026

## social

- **/leaderboard** : Top 3 utilizatori Bacalaurescu (după XP)

## ajutor

- **/help** : Lista completă de comenzi disponibile