Обновить README.md

Signed-off-by: Хомячок <hamyack@noreply.localhost>
This commit is contained in:
2026-03-05 22:03:58 +00:00
parent e216cbb95e
commit b4561a0a15

View File

@@ -2,7 +2,7 @@
<img src="assets/Logo.png" alt="Virome API" width="120"> <img src="assets/Logo.png" alt="Virome API" width="120">
<h1 style="margin:0; font-size:60px; line-height:1;"> <h1 style="margin:0; font-size:60px; line-height:1;">
Virome API Muza API
</h1> </h1>
</div> </div>
@@ -17,7 +17,6 @@
--- ---
## Features ## Features
- Search songs, albums, artists with fallback video IDs for playback - Search songs, albums, artists with fallback video IDs for playback
- Get synced lyrics (LRC format) - Get synced lyrics (LRC format)
- Stream audio via Piped/Invidious proxies - Stream audio via Piped/Invidious proxies
@@ -27,93 +26,5 @@
- Built-in music player with YouTube IFrame API - Built-in music player with YouTube IFrame API
- Auto region detection from IP - Auto region detection from IP
## Quick Start
```bash
deno run --allow-net --allow-env --allow-read mod.ts
```
Server runs at `http://localhost:8000`
## API Endpoints
### Search
| Endpoint | Description |
|----------|-------------|
| `/api/search?q=&filter=` | Search YouTube Music (songs/albums/artists) |
| `/api/yt_search?q=&filter=` | Search YouTube (videos/channels/playlists) |
| `/api/search/suggestions?q=` | Autocomplete suggestions |
### Content
| Endpoint | Description |
|----------|-------------|
| `/api/songs/:videoId` | Song details with artist/album links |
| `/api/albums/:browseId` | Album with tracks and artist |
| `/api/artists/:browseId` | Artist with discography |
| `/api/playlists/:playlistId` | Playlist tracks |
| `/api/chain/:videoId` | Full chain: Song → Artist → Albums |
### Discovery
| Endpoint | Description |
|----------|-------------|
| `/api/related/:videoId` | Related songs |
| `/api/radio?videoId=` | Generate radio mix |
| `/api/similar?title=&artist=` | Similar tracks |
| `/api/charts?country=` | Music charts |
| `/api/trending?country=` | Trending music |
| `/api/moods` | Mood categories |
| `/api/top/artists?country=` | Top artists |
| `/api/top/tracks?country=` | Top tracks |
### Streaming & Lyrics
| Endpoint | Description |
|----------|-------------|
| `/api/stream?id=` | Audio stream URLs |
| `/api/proxy?url=` | Audio proxy (CORS bypass) |
| `/api/lyrics?title=&artist=` | Synced lyrics (LRC) |
### Info
| Endpoint | Description |
|----------|-------------|
| `/api/artist/info?artist=` | Artist bio (Last.fm) |
| `/api/track/info?title=&artist=` | Track info (Last.fm) |
## Examples
```bash
# Search songs
curl "https://verome-api.deno.dev/api/search?q=Blinding%20Lights&filter=songs"
# Get lyrics
curl "https://verome-api.deno.dev/api/lyrics?title=Blinding%20Lights&artist=The%20Weeknd"
# Stream URLs
curl "https://verome-api.deno.dev/api/stream?id=4NRXx6U8ABQ"
# Radio mix
curl "https://verome-api.deno.dev/api/radio?videoId=4NRXx6U8ABQ"
```
## Project Structure
```
mod.ts - Server and routes
lib.ts - API clients (YT Music, YouTube, Last.fm, LRCLib)
ui.ts - Web UI
assets/ - Logo
```
## Deploy
```bash
deployctl deploy --project=verome-api --prod mod.ts
```
## License ## License
MIT MIT