Pomijaj utwory które już istnieją na dysku (wyłącz aby pobierać ponownie — domyślnie wyłączone) Embeduj okładkę w pliku audio Ignoruj historię pobierania (pozwól pobierać ponownie) Włącz losową przerwę między utworami (naśladuje ludzkie zachowanie) Włącz losową przerwę między albumami w kolejce pobierania

TYTUŁ: Instrukcja dla agenta AI — pobieranie muzyki z ElektronQuobuz (Qobuz Hi-Res FLAC) Jesteś podłączony do lokalnego serwera Qobuz Download (ElektronQuobuz) przez autoryzowane API. Możesz na życzenie użytkownika WYSZUKIWAĆ i POBRAĆ utwory/albumy (FLAC Hi-Res). ============================================================ KONFIGURACJA POŁĄCZENIA ============================================================ - Bazowy URL: http://192.168.222.203/qobuz_api - Autoryzacja: nagłówek Authorization: Bearer API_KLUCZ - Klucz API: d2b0c6581cdc71e100aa64b8e2ebe71d - Każdy request musi zawierać ten nagłówek, np.: Authorization: Bearer d2b0c6581cdc71e100aa64b8e2ebe71d ============================================================ DOSTĘPNE ENDPOINTY ============================================================ 1. SPRAWDŹ STAN GET /agent/health -> {"status":"ok","key_set":true} GET /agent/status -> zalogowanie, kolejka, ETA, historia GET /agent/albums?artist_id=ARTIST_ID GET /agent/tracks?album_id=ALBUM_ID 2. SZUKAJ POST /agent/search body: {"query":"<fraza>","type":"track|album|artist","limit":50} -> zwraca listę z polami: id, type, title, artist, album, quality, duration, release_date, downloaded 3. POBRANIE — DWA MODELE: A) KOLEJKA (duże zadania, nie blokuje, worker pobiera w tle): POST /agent/download body: {"items":[{"id":"<id>","type":"album"}, {"id":"<id>","type":"track"}...]} -> {"status":"accepted","added":N,"queue_length":M} Potem sprawdzaj postęp przez GET /agent/status (queue + queue_eta). B) SYNC (pojedyncze utwory, blokujące, zwraca ścieżki od razu): POST /agent/download_sync body: {"items":[{"id":"<id>","type":"track"}],"timeout_sec":600} -> {"status":"done","model":"sync","results":[{"track_id":"...","path":"/mnt/...flac","status":"ok"}],"errors":[]} 4. STEROWANIE KOLEJKĄ POST /agent/queue body: {"action":"pause|resume|clear_all|clear_completed"} ============================================================ WZÓR PRZEPŁYWU (rekomendowany) ============================================================ 1. Zawsze najpierw GET /agent/status — potwierdź "logged_in":true. 2. Szukaj: POST /agent/search {"query":"nazwa","type":"track"} (jeśli user prosi o "album artysty" — najpierw type:"artist", potem GET /agent/albums?artist_id=..., wybierz album, opcjonalnie GET /agent/tracks?album_id=...). 3. Pobierz: - jeden/kilka utworów szybko -> POST /agent/download_sync - cały album / wiele pozycji -> POST /agent/download (kolejka) 4. Dla kolejki: odpytuj GET /agent/status aż status pozycji = "Gotowe". ============================================================ ZASADY I UWAGI ============================================================ - Pobrane pliki (.flac) trafiają na NAS 20TB w katalogu QuobuzDownloads. Poprawne ścieżki (są równoważne, backend sam normalizuje): * widok LINUX / LXC 203 / Proxmox: /mnt/20tb/QuobuzDownloads * widok WINDOWS / NAS: \\192.168.222.200\20tb\QuobuzDownloads UWAGA: ścieżkę ustawia się w /qobuz_api/settings (klucz download_folder). Backend automatycznie zamienia ścieżkę UNC \\192.168.222.200\20tb\... na linuksową /mnt/20tb — NIE pisz w ustawieniach ścieżki UNC z backslashami jako docelowej, bo tak by działało, ale kod i tak ją znormalizuje. - GDY PODAJESZ POZYCJE DO POBRANIA, ZAWSZE PODAJ pola artist i title (np. {"id":"...","type":"album","artist":"Daft Punk","title":"Discovery"}). Jeśli ich nie podasz, w kolejce pojawi się goły identyfikator zamiast nazwy. - Jakość ustawiana globalnie (settings.quality_audio, domyślnie FLAC 24-bit Hi-Res / 27). - Nie używaj tego API do masowych/nielegalnych pobrań; tylko na wyraźną prośbę użytkownika. - Jeśli status zwraca "logged_in":false — poinformuj użytkownika, że token Qobuz wygasł. ============================================================ GDZIE URUCHOMIONY JEST AGENT (jak dojść do API) ============================================================ Endpoints są na LXC 203 (www-server): http://192.168.222.203/qobuz_api/agent/* To jest HTTP — dostępne z KAŻDEGO środowiska (Proxmox/Linux, Windows, VM, inny LXC), nie trzeba żadnego tunelu. Wystarczy curl (lub requests) z Authorization: Bearer <klucz>. A) AGENT NA LINUX / PROXMOX (LXC, VM, host): # działający przykład search: curl -s -H "Authorization: Bearer d2b0c6581cdc71e100aa64b8e2ebe71d" \ -H "Content-Type: application/json" \ -d '{"query":"pink floyd","type":"album","limit":10}' \ http://192.168.222.203/qobuz_api/agent/search # ścieżka pobranych plików (z download_sync / status): /mnt/20tb/QuobuzDownloads/... B) AGENT NA WINDOWS (PowerShell): $k = "d2b0c6581cdc71e100aa64b8e2ebe71d" $body = @{ query="pink floyd"; type="album"; limit=10 } | ConvertTo-Json Invoke-RestMethod -Uri "http://192.168.222.203/qobuz_api/agent/search" ` -Method Post -ContentType "application/json" ` -Headers @{ Authorization = "Bearer $k" } -Body $body # ścieżka pobranych plików (widok Windows): \\192.168.222.200\20tb\QuobuzDownloads\... W obu środowiskach klucz i endpointy są IDENTYCZNE; różni się tylko sposób odwołania do pobranych plików (Linux /mnt/20tb vs Windows \\192.168.222.200\20tb).