{"creator": "ElitePlex", "openapi": "3.1.0", "info": {"title": "ElitePlex API", "description": "Multi-provider streaming API\n\n**Catalog** `/api/*` · **Play** embeds · **Music** · **Downloader** (yt-dlp + ffmpeg merge)\n**MovieBox** `/mb/*` · **4KHDHub** `/fk/*` · **Tools** `/tools/*`", "version": "5.23.0"}, "paths": {"/health": {"get": {"tags": ["Meta"], "summary": "Health", "operationId": "health_health_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/proxy/file/{token}": {"get": {"tags": ["Playback"], "summary": "Proxy File", "operationId": "proxy_file_proxy_file__token__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/proxy/cdn/{token}/{path}": {"get": {"tags": ["Playback"], "summary": "Proxy Cdn", "description": "Segment/path under CDN — TUI equivalent of /https/host/path with auth.", "operationId": "proxy_cdn_proxy_cdn__token___path__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}, {"name": "path", "in": "path", "required": true, "schema": {"type": "string", "title": "Path"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "head": {"tags": ["Playback"], "summary": "Proxy Cdn", "description": "Segment/path under CDN — TUI equivalent of /https/host/path with auth.", "operationId": "proxy_cdn_proxy_cdn__token___path__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}, {"name": "path", "in": "path", "required": true, "schema": {"type": "string", "title": "Path"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/proxy/{token}": {"get": {"tags": ["Playback"], "summary": "Proxy Legacy", "operationId": "proxy_legacy_proxy__token__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/search": {"get": {"tags": ["MovieBox"], "summary": "Mb Search", "description": "Search MovieBox catalog. Use returned `subject_id` with /mb/stream and /mb/detail.", "operationId": "mb_search_mb_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "description": "Search query", "title": "Q"}, "description": "Search query"}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/movies": {"get": {"tags": ["MovieBox"], "summary": "Mb Movies", "description": "Paginated MovieBox **movies** only.", "operationId": "mb_movies_mb_movies_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "per_page", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Per Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/series": {"get": {"tags": ["MovieBox"], "summary": "Mb Series", "description": "Paginated MovieBox **series / TV** only.", "operationId": "mb_series_mb_series_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "per_page", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Per Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/movies": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Movies", "description": "Movies list with pager (PaxSenix-style path).", "operationId": "moviebox_movies_moviebox_movies_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "perPage", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Perpage"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/series": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Series", "description": "Series list with pager (PaxSenix-style path).", "operationId": "moviebox_series_moviebox_series_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "perPage", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Perpage"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/resource/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Resource", "description": "MovieBox community/server **resource** list (from MovieBox-TUI).\nHigher bitrate mirrors alongside play-info DASH.", "operationId": "mb_resource_mb_resource__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "perPage", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Perpage"}}, {"name": "resolution", "in": "query", "required": false, "schema": {"type": "integer", "description": "0=all, or 480/720/1080", "default": 0, "title": "Resolution"}, "description": "0=all, or 480/720/1080"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/suggest": {"get": {"tags": ["MovieBox"], "summary": "Mb Suggest", "description": "Autocomplete-style search (first page of search/v2).", "operationId": "mb_suggest_mb_suggest_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/rank": {"get": {"tags": ["MovieBox"], "summary": "Mb Rank", "description": "Trending rank: movies + TV (search-rank).", "operationId": "mb_rank_mb_rank_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/season/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Season", "description": "Season / episode structure for a series.", "operationId": "mb_season_mb_season__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/play/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Play", "description": "Unified MovieBox play: play-info DASH (proxied) + resource mirrors.\nPreferred entry for clients.", "operationId": "mb_play_mb_play__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/detail/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Detail", "description": "Full metadata for a MovieBox title. Series include season info.", "operationId": "mb_detail_mb_detail__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/stream/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Stream", "description": "**One play endpoint for a MovieBox subject_id.**\n\n- `mp4` — progressive files if any (all phones)\n- `sources` — DASH/MPD + headers (HEVC; use VLC)\n- `qualities` — MPD broken into 1080/720/480\n- `play` — best single URL to open first", "operationId": "mb_stream_mb_stream__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/home": {"get": {"tags": ["MovieBox"], "summary": "Mb Home", "description": "Homepage operating tabs from MovieBox.", "operationId": "mb_home_mb_home_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/captions/{subject_id}": {"get": {"tags": ["MovieBox"], "summary": "Mb Captions", "description": "Subtitles for a MovieBox stream. Pass resource_id from /mb/stream sources[].id.", "operationId": "mb_captions_mb_captions__subject_id__get", "parameters": [{"name": "subject_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Subject Id"}}, {"name": "resource_id", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Resource Id"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/fk/search": {"get": {"tags": ["4KHDHub"], "summary": "Fk Search", "description": "Search 4KHDHub. Use returned `id` (path) with /fk/detail and /fk/stream.", "operationId": "fk_search_fk_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/fk/detail": {"get": {"tags": ["4KHDHub"], "summary": "Fk Detail", "description": "Metadata for a 4KHDHub page.", "operationId": "fk_detail_fk_detail_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Path from search, e.g. /movie-name/", "title": "Id"}, "description": "Path from search, e.g. /movie-name/"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/fk/stream": {"get": {"tags": ["4KHDHub"], "summary": "Fk Stream", "description": "4KHDHub releases + **direct streaming links**.\n\nBy default (`resolve=true`) every HubCloud / HubDrive / PixelDrain mirror is\nexpanded into playable CDN URLs. Flat list is in `streams` for the player.", "operationId": "fk_stream_fk_stream_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Path from /fk/search", "title": "Id"}, "description": "Path from /fk/search"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}, {"name": "resolve", "in": "query", "required": false, "schema": {"type": "boolean", "description": "Expand HubCloud/HubDrive to direct stream URLs (default true)", "default": true, "title": "Resolve"}, "description": "Expand HubCloud/HubDrive to direct stream URLs (default true)"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 40, "minimum": 1, "description": "Max mirrors to resolve", "default": 12, "title": "Limit"}, "description": "Max mirrors to resolve"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/fk/play": {"get": {"tags": ["4KHDHub"], "summary": "Fk Play", "description": "Shortcut: always resolve and return only playable streams.", "operationId": "fk_play_fk_play_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Path from /fk/search", "title": "Id"}, "description": "Path from /fk/search"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/resolve": {"get": {"tags": ["Tools"], "summary": "Tools Resolve", "description": "Resolve HubCloud / HubDrive page into direct CDN download URLs\n(PixelDrain, Cloudflare R2, FSL, Google storage, etc.).", "operationId": "tools_resolve_tools_resolve_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "hubcloud.*/drive/... or hubdrive.*/file/...", "title": "Url"}, "description": "hubcloud.*/drive/... or hubdrive.*/file/..."}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/hubcloud": {"get": {"tags": ["Tools"], "summary": "Tools Hubcloud", "description": "Resolve HubCloud drive page → all direct mirrors (FSL, PixelDrain, 10Gbps, Watch…).", "operationId": "tools_hubcloud_tools_hubcloud_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "https://hubcloud.ist/drive/xxx", "title": "Url"}, "description": "https://hubcloud.ist/drive/xxx"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/hubdrive": {"get": {"tags": ["Tools"], "summary": "Tools Hubdrive", "description": "Resolve HubDrive file → HubCloud → direct mirrors.", "operationId": "tools_hubdrive_tools_hubdrive_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "https://hubdrive.pics/file/xxx", "title": "Url"}, "description": "https://hubdrive.pics/file/xxx"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/resolve/batch": {"get": {"tags": ["Tools"], "summary": "Tools Resolve Batch", "description": "Resolve many Hub links at once.", "operationId": "tools_resolve_batch_tools_resolve_batch_get", "parameters": [{"name": "urls", "in": "query", "required": true, "schema": {"type": "string", "description": "Comma-separated HubCloud/HubDrive URLs", "title": "Urls"}, "description": "Comma-separated HubCloud/HubDrive URLs"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/search": {"get": {"tags": ["Aggregate"], "summary": "Search All", "description": "Search MovieBox + 4KHDHub in parallel-ish sequential calls.", "operationId": "search_all_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/home": {"get": {"tags": ["Catalog"], "summary": "Api Home", "description": "Home feed for the web.\n\n- TMDB trending/popular rows\n- `netplay_admin` — optional direct-MP4 list (UUID ids, not MovieBox subject_id)", "operationId": "api_home_api_home_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/api/movies": {"get": {"tags": ["Catalog"], "summary": "Api Movies", "operationId": "api_movies_api_movies_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/series": {"get": {"tags": ["Catalog"], "summary": "Api Series", "operationId": "api_series_api_series_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/search": {"get": {"tags": ["Catalog"], "summary": "Api Search Catalog", "description": "Unified search for the web + API clients.\n\n**IDs**\n- `subject_id` / `id_type=moviebox_subject` → main catalog (same as Netplay app movies)\n- `netplay_id` / `id_type=netplay_uuid` → admin MP4 list only (`/np/videos`)\n- `tmdb_id` → embed helpers\n\nPlay MovieBox: `GET /play?subject_id=...` or `GET /mb/stream/{subject_id}`", "operationId": "api_search_catalog_api_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/detail/{media}/{item_id}": {"get": {"tags": ["Catalog"], "summary": "Api Detail", "description": "TMDB detail for web. item_id = TMDB id. MovieBox remains on /mb/detail/{id}.", "operationId": "api_detail_api_detail__media___item_id__get", "parameters": [{"name": "media", "in": "path", "required": true, "schema": {"type": "string", "title": "Media"}}, {"name": "item_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Item Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/tv/{item_id}/season/{season}": {"get": {"tags": ["Catalog"], "summary": "Api Season", "description": "TMDB season episodes (ascending).", "operationId": "api_season_api_tv__item_id__season__season__get", "parameters": [{"name": "item_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Item Id"}}, {"name": "season", "in": "path", "required": true, "schema": {"type": "integer", "title": "Season"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/vix/stream": {"get": {"tags": ["Direct"], "summary": "Vix Stream", "description": "VixSrc direct HLS (TMDB id) — used by modern embed aggregators.", "operationId": "vix_stream_vix_stream_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/direct/stream": {"get": {"tags": ["Direct"], "summary": "Direct Stream", "description": "Aggregate **direct** streams + embeds for one title.\nOrder: VixSrc HLS → 4KHDHub direct → embeds → optional NetMirror/MovieBox.", "operationId": "direct_stream_direct_stream_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "title": "Title"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Ep"}}, {"name": "include_embeds", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Include Embeds"}}, {"name": "include_vixsrc", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Include Vixsrc"}}, {"name": "include_4k", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Include 4K"}}, {"name": "include_netmirror", "in": "query", "required": false, "schema": {"type": "boolean", "default": false, "title": "Include Netmirror"}}, {"name": "include_moviebox", "in": "query", "required": false, "schema": {"type": "boolean", "default": false, "title": "Include Moviebox"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/direct/download": {"get": {"tags": ["Direct"], "summary": "Direct Download", "description": "Direct download links:\n- 4KHDHub / HubCloud resolve\n- optional yt-dlp on any `url`\n- VixSrc downloadUrl when available", "operationId": "direct_download_direct_download_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "title": "Title"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}, {"name": "url", "in": "query", "required": false, "schema": {"type": "string", "description": "Optional page/file URL to resolve via yt-dlp / HubCloud", "title": "Url"}, "description": "Optional page/file URL to resolve via yt-dlp / HubCloud"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/nm/search": {"get": {"tags": ["NetMirror"], "summary": "Nm Search", "description": "NetMirror title search (OTT library). Soft-fails with empty items if host blocked.", "operationId": "nm_search_nm_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "description": "netflix|prime|hotstar|disney", "default": "netflix", "title": "Platform"}, "description": "netflix|prime|hotstar|disney"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/nm/detail": {"get": {"tags": ["NetMirror"], "summary": "Nm Detail", "description": "NetMirror post/detail (seasons / episodes metadata).", "operationId": "nm_detail_nm_detail_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "NetMirror content id from /nm/search", "title": "Id"}, "description": "NetMirror content id from /nm/search"}, {"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "default": "netflix", "title": "Platform"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/nm/stream": {"get": {"tags": ["NetMirror"], "summary": "Nm Stream", "description": "NetMirror direct stream (usually HLS .m3u8).\nPass `id` from search, or `title` to search+play in one call.", "operationId": "nm_stream_nm_stream_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Content or episode id", "title": "Id"}, "description": "Content or episode id"}, {"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "default": "netflix", "title": "Platform"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "description": "Optional title — search then play first match", "title": "Title"}, "description": "Optional title — search then play first match"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/nm/play": {"get": {"tags": ["NetMirror"], "summary": "Nm Play", "description": "Search + stream in one call (NetMirror).", "operationId": "nm_play_nm_play_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "description": "Title to search", "title": "Q"}, "description": "Title to search"}, {"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "default": "netflix", "title": "Platform"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/sources": {"get": {"tags": ["Providers"], "summary": "Sources Catalog", "description": "UI source server list (NetMirror, SpaceDom, Source 3, Source 6, …).", "operationId": "sources_catalog_sources_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/sources/play": {"get": {"tags": ["Providers"], "summary": "Sources Play", "description": "Play via a named source server.", "operationId": "sources_play_sources_play_get", "parameters": [{"name": "source", "in": "query", "required": true, "schema": {"type": "string", "description": "netmirror|spacedom|source3|source6|or embed id", "title": "Source"}, "description": "netmirror|spacedom|source3|source6|or embed id"}, {"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "title": "Title"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Ep"}}, {"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "default": "netflix", "title": "Platform"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/providers/list": {"get": {"tags": ["Providers"], "summary": "Providers List", "description": "All embed providers (KiduyuTv + FilmSnaps style) + FilmSnaps CDN hosts.", "operationId": "providers_list_providers_list_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/providers/embeds": {"get": {"tags": ["Providers"], "summary": "Providers Embeds", "description": "KiduyuTv + FilmSnaps-style embed URLs for a title.", "operationId": "providers_embeds_providers_embeds_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": true, "schema": {"type": "integer", "description": "TMDB id", "title": "Tmdb Id"}, "description": "TMDB id"}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "description": "movie | tv", "default": "movie", "title": "Media"}, "description": "movie | tv"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "description": "season (tv)", "default": 1, "title": "Se"}, "description": "season (tv)"}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "description": "episode (tv)", "default": 1, "title": "Ep"}, "description": "episode (tv)"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/providers/streams": {"get": {"tags": ["Providers"], "summary": "Providers Streams", "description": "Aggregate play sources:\n- full embed catalog (Kiduyu + FilmSnaps hosts)\n- optional MovieBox DASH proxy (if title/subject resolved)\n- optional 4KHDHub direct streams (if title search hits)", "operationId": "providers_streams_providers_streams_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Ep"}}, {"name": "include_embeds", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Include Embeds"}}, {"name": "include_moviebox", "in": "query", "required": false, "schema": {"type": "boolean", "default": false, "title": "Include Moviebox"}}, {"name": "include_4k", "in": "query", "required": false, "schema": {"type": "boolean", "default": false, "title": "Include 4K"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "title": "Title"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/providers/subtitles": {"get": {"tags": ["Providers"], "summary": "Providers Subtitles", "description": "Wyzie-style open subtitle lookup (FilmSnaps uses sub.wyzie.io).", "operationId": "providers_subtitles_providers_subtitles_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "imdb_id", "in": "query", "required": false, "schema": {"type": "string", "title": "Imdb Id"}}, {"name": "query", "in": "query", "required": false, "schema": {"type": "string", "title": "Query"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/play": {"get": {"tags": ["Playback"], "summary": "Api Play", "description": "Web playback: embeds immediately; optional 4KHDHub when fast=false.", "operationId": "api_play_api_play_get", "parameters": [{"name": "subject_id", "in": "query", "required": false, "schema": {"type": "string", "description": "Legacy MovieBox id — ignored on web path", "title": "Subject Id"}, "description": "Legacy MovieBox id — ignored on web path"}, {"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "string", "description": "TMDB id for web playback", "title": "Tmdb Id"}, "description": "TMDB id for web playback"}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Media"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}, {"name": "q", "in": "query", "required": false, "schema": {"type": "string", "description": "Title for 4KHDHub match / TMDB lookup", "default": "", "title": "Q"}, "description": "Title for 4KHDHub match / TMDB lookup"}, {"name": "fast", "in": "query", "required": false, "schema": {"type": "boolean", "description": "Skip slow 4K resolve (embeds only) — set false for hub list", "default": true, "title": "Fast"}, "description": "Skip slow 4K resolve (embeds only) — set false for hub list"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/movie/search": {"get": {"tags": ["Movies"], "summary": "Movie Search", "description": "Unified movie search: TMDB + MovieBox + 4KHDHub (parallel).", "operationId": "movie_search_movie_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/movie/play": {"get": {"tags": ["Movies"], "summary": "Movie Play", "description": "Aggregate play sources: embed servers + MovieBox DASH proxy + 4K direct streams.", "operationId": "movie_play_movie_play_get", "parameters": [{"name": "title", "in": "query", "required": false, "schema": {"type": "string", "description": "Title to match", "title": "Title"}, "description": "Title to match"}, {"name": "tmdb_id", "in": "query", "required": false, "schema": {"type": "integer", "title": "Tmdb Id"}}, {"name": "media", "in": "query", "required": false, "schema": {"type": "string", "description": "movie|tv", "default": "movie", "title": "Media"}, "description": "movie|tv"}, {"name": "subject_id", "in": "query", "required": false, "schema": {"type": "string", "description": "MovieBox subject id", "title": "Subject Id"}, "description": "MovieBox subject id"}, {"name": "fk_id", "in": "query", "required": false, "schema": {"type": "string", "description": "4KHDHub path id", "title": "Fk Id"}, "description": "4KHDHub path id"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/search": {"get": {"tags": ["Music"], "summary": "Music Search", "description": "Search JioSaavn (primary, reliable streams) + YouTube Music.", "operationId": "music_search_music_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/home": {"get": {"tags": ["Music"], "summary": "Music Home", "description": "Home rows — limited seeds to keep memory/CPU low on small hosts.", "operationId": "music_home_music_home_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/music/play/{item_id}": {"get": {"tags": ["Music"], "summary": "Music Play", "description": "Playable audio stream — vivi-music style:\n1) JioSaavn direct CDN (reliable)\n2) yt-dlp multi-client fallback\n3) YouTube embed fallback\nitem_id = saavn:ID  OR  11-char YouTube video id", "operationId": "music_play_music_play__item_id__get", "parameters": [{"name": "item_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Item Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/lyrics": {"get": {"tags": ["Music"], "summary": "Music Lyrics", "description": "LRCLIB lyrics — plain + synced (LRC). Used by SimpMusic / vivi-music.\n\nBad sync is almost always a wrong-match problem, not a parsing problem:\nthe same title can have many recordings (covers, remixes, re-releases)\nwith different timings. LRCLIB's own /api/get does an exact, duration-\nvalidated match (±2s) when we can give it artist+duration, which is far\nmore reliable than the old fuzzy-search-only approach. We fall back to\na better-scored fuzzy search (title AND artist, not title alone) only\nwhen the exact lookup can't find anything.", "operationId": "music_lyrics_music_lyrics_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "description": "Artist name optional", "default": "", "title": "Artist"}, "description": "Artist name optional"}, {"name": "album", "in": "query", "required": false, "schema": {"type": "string", "description": "Album name optional, improves LRCLIB match precision", "default": "", "title": "Album"}, "description": "Album name optional, improves LRCLIB match precision"}, {"name": "duration", "in": "query", "required": false, "schema": {"type": "number", "description": "Track duration in seconds — LRCLIB matches within ±2s of this", "default": 0, "title": "Duration"}, "description": "Track duration in seconds — LRCLIB matches within ±2s of this"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/deezer/search": {"get": {"tags": ["Music"], "summary": "Music Deezer Search", "description": "Deezer public search — metadata + 30s preview (PyMusic / Spotube style).", "operationId": "music_deezer_search_music_deezer_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 40, "minimum": 1, "default": 15, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/suggest": {"get": {"tags": ["Music"], "summary": "Music Suggest", "description": "Search suggestions (Piped + light YT-style).", "operationId": "music_suggest_music_suggest_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/piped/search": {"get": {"tags": ["Music"], "summary": "Music Piped Search", "description": "Piped search (SimpMusic / simplyMusic style). Stream via /music/play/{yt_id}.", "operationId": "music_piped_search_music_piped_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "filter", "in": "query", "required": false, "schema": {"type": "string", "description": "music_songs|all|videos", "default": "music_songs", "title": "Filter"}, "description": "music_songs|all|videos"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/piped/stream/{video_id}": {"get": {"tags": ["Music"], "summary": "Music Piped Stream", "description": "Piped stream lookup (SimpMusic / simplyMusic style).\nReturns audio if available; otherwise video/mp4 + related metadata.\nFalls back to yt-dlp / existing play pipeline when Piped has no audio.", "operationId": "music_piped_stream_music_piped_stream__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/stream": {"get": {"tags": ["Music"], "summary": "Music Stream Resolve", "description": "Universal music stream resolver.\n- saavn:xxx → full JioSaavn CDN\n- yt:xxx / 11-char id → Piped + yt-dlp audio\n- deezer:xxx → 30s preview\n- q=title → search Saavn then stream first hit", "operationId": "music_stream_resolve_music_stream_get", "parameters": [{"name": "id", "in": "query", "required": false, "schema": {"type": "string", "description": "saavn:ID | yt:VIDEO | VIDEO_ID | deezer:ID", "title": "Id"}, "description": "saavn:ID | yt:VIDEO | VIDEO_ID | deezer:ID"}, {"name": "q", "in": "query", "required": false, "schema": {"type": "string", "description": "Search title if no id", "title": "Q"}, "description": "Search title if no id"}, {"name": "video_id", "in": "query", "required": false, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/deezer/play/{track_id}": {"get": {"tags": ["Music"], "summary": "Music Deezer Play", "description": "Deezer track preview stream (30s).", "operationId": "music_deezer_play_music_deezer_play__track_id__get", "parameters": [{"name": "track_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Track Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/charts": {"get": {"tags": ["Music"], "summary": "Music Charts", "description": "Quick charts via curated Saavn searches + Deezer chart.", "operationId": "music_charts_music_charts_get", "parameters": [{"name": "region", "in": "query", "required": false, "schema": {"type": "string", "description": "in|us|global", "default": "in", "title": "Region"}, "description": "in|us|global"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/unified": {"get": {"tags": ["Music"], "summary": "Music Unified", "description": "One-shot search across JioSaavn + YT Music + Deezer + Piped (SimpMusic-style aggregator).", "operationId": "music_unified_music_unified_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/plain": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Plain", "operationId": "lyrics_plain_lyrics_plain_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/lrcget": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Lrcget", "description": "Synced LRC lyrics (LRCLIB) — same engine as /music/lyrics.", "operationId": "lyrics_lrcget_lyrics_lrcget_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}, {"name": "album", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Album"}}, {"name": "duration", "in": "query", "required": false, "schema": {"type": "number", "default": 0, "title": "Duration"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/genius": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Genius", "description": "Genius lyrics search via public pages (best-effort).", "operationId": "lyrics_genius_lyrics_genius_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/multi": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Multi", "description": "All lyric sources in one call: LRCLIB (synced) + plain.", "operationId": "lyrics_multi_lyrics_multi_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}, {"name": "duration", "in": "query", "required": false, "schema": {"type": "number", "default": 0, "title": "Duration"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/search": {"get": {"tags": ["Deezer"], "summary": "Deezer Search", "operationId": "deezer_search_deezer_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/track": {"get": {"tags": ["Deezer"], "summary": "Deezer Track", "operationId": "deezer_track_deezer_track_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/album": {"get": {"tags": ["Deezer"], "summary": "Deezer Album", "operationId": "deezer_album_deezer_album_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/artist": {"get": {"tags": ["Deezer"], "summary": "Deezer Artist", "operationId": "deezer_artist_deezer_artist_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/playlist": {"get": {"tags": ["Deezer"], "summary": "Deezer Playlist", "operationId": "deezer_playlist_deezer_playlist_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "integer", "title": "Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/deezer/home": {"get": {"tags": ["Deezer"], "summary": "Deezer Home", "operationId": "deezer_home_deezer_home_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/jiosaavn/search": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Search", "operationId": "jiosaavn_search_jiosaavn_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/jiosaavn/track": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Track", "operationId": "jiosaavn_track_jiosaavn_track_get", "parameters": [{"name": "id", "in": "query", "required": false, "schema": {"type": "string", "title": "Id"}}, {"name": "q", "in": "query", "required": false, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/jiosaavn/charts": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Charts", "description": "Official Saavn charts list.", "operationId": "jiosaavn_charts_jiosaavn_charts_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/jiosaavn/album": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Album", "operationId": "jiosaavn_album_jiosaavn_album_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Album id", "title": "Id"}, "description": "Album id"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/jiosaavn/playlist": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Playlist", "operationId": "jiosaavn_playlist_jiosaavn_playlist_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "title": "Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/jiosaavn/artist": {"get": {"tags": ["JioSaavn"], "summary": "Jiosaavn Artist", "operationId": "jiosaavn_artist_jiosaavn_artist_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "title": "Id"}}, {"name": "q", "in": "query", "required": false, "schema": {"type": "string", "description": "Or search by name", "title": "Q"}, "description": "Or search by name"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/songlink": {"get": {"tags": ["Tools"], "summary": "Tools Songlink", "description": "Find the same song across platforms (I don't have Spotify style).\nReturns JioSaavn + Deezer + YT Music matches.", "operationId": "tools_songlink_tools_songlink_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/idonthavespotify": {"get": {"tags": ["Tools"], "summary": "Tools Idonthavespotify", "description": "Resolve Spotify URL or title to free playable alternatives.", "operationId": "tools_idonthavespotify_tools_idonthavespotify_get", "parameters": [{"name": "url", "in": "query", "required": false, "schema": {"type": "string", "description": "Spotify track URL", "title": "Url"}, "description": "Spotify track URL"}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/related": {"get": {"tags": ["Music"], "summary": "Music Related", "description": "Recommended / similar songs (JioSaavn search around query).", "operationId": "music_related_music_related_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 8, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/stream/{token}": {"get": {"tags": ["Music"], "summary": "Music Stream Proxy", "description": "Proxy Saavn audio with streaming (low memory) + Range + CORS.", "operationId": "music_stream_proxy_music_stream__token__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "head": {"tags": ["Music"], "summary": "Music Stream Proxy", "description": "Proxy Saavn audio with streaming (low memory) + Range + CORS.", "operationId": "music_stream_proxy_music_stream__token__get", "parameters": [{"name": "token", "in": "path", "required": true, "schema": {"type": "string", "title": "Token"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/info": {"get": {"tags": ["Downloader"], "summary": "Dl Info", "description": "Probe any media page (yt-dlp) — list formats + direct URLs.", "operationId": "dl_info_dl_info_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/audio": {"get": {"tags": ["Downloader"], "summary": "Dl Audio", "description": "Best audio-only stream for a page URL.", "operationId": "dl_audio_dl_audio_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/smart": {"get": {"tags": ["Downloader"], "summary": "Dl Smart", "description": "Prefer muxed file; else video+audio pair for /dl/combine.", "operationId": "dl_smart_dl_smart_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/extract": {"get": {"tags": ["Downloader"], "summary": "Dl Extract", "description": "Universal format list (yt-dlp · 1000+ sites).", "operationId": "dl_extract_dl_extract_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/any": {"get": {"tags": ["Downloader"], "summary": "Dl Any", "description": "One endpoint for everything:\nHubCloud / HubDrive / PixelDrain / YouTube / TikTok / Instagram / X / Facebook / …", "operationId": "dl_any_dl_any_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/jiosaavn": {"get": {"tags": ["Downloader"], "summary": "Dl Jiosaavn", "description": "JioSaavn downloader — direct CDN links (unlimited).", "operationId": "dl_jiosaavn_dl_jiosaavn_get", "parameters": [{"name": "url", "in": "query", "required": false, "schema": {"type": "string", "description": "JioSaavn song URL or bare query", "title": "Url"}, "description": "JioSaavn song URL or bare query"}, {"name": "q", "in": "query", "required": false, "schema": {"type": "string", "description": "Search query", "title": "Q"}, "description": "Search query"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/spotify": {"get": {"tags": ["Downloader"], "summary": "Dl Spotify", "description": "Spotify downloader (unlimited). Resolves track meta via oEmbed,\nthen fetches full audio from JioSaavn / YouTube (no Spotify DRM).", "operationId": "dl_spotify_dl_spotify_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "Spotify track URL or spotify:track:ID", "title": "Url"}, "description": "Spotify track URL or spotify:track:ID"}, {"name": "server", "in": "query", "required": false, "schema": {"type": "string", "description": "auto|jiosaavn|youtube", "default": "auto", "title": "Server"}, "description": "auto|jiosaavn|youtube"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/deezer": {"get": {"tags": ["Downloader"], "summary": "Dl Deezer", "description": "Deezer downloader — preview + full match via JioSaavn/YouTube.", "operationId": "dl_deezer_dl_deezer_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "Deezer track URL or numeric id", "title": "Url"}, "description": "Deezer track URL or numeric id"}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "description": "Preferred quality label", "default": "320kbps", "title": "Quality"}, "description": "Preferred quality label"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/tidal": {"get": {"tags": ["Downloader"], "summary": "Dl Tidal", "description": "Tidal → title match → JioSaavn/YouTube full audio.", "operationId": "dl_tidal_dl_tidal_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "Tidal track URL or title search", "title": "Url"}, "description": "Tidal track URL or title search"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/qobuz": {"get": {"tags": ["Downloader"], "summary": "Dl Qobuz", "description": "Qobuz → match full audio (JioSaavn/YouTube).", "operationId": "dl_qobuz_dl_qobuz_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "default": "320kbps", "title": "Quality"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/applemusic": {"get": {"tags": ["Downloader"], "summary": "Dl Applemusic", "description": "Apple Music URL → oEmbed/title match → full audio.", "operationId": "dl_applemusic_dl_applemusic_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/amazonmusic": {"get": {"tags": ["Downloader"], "summary": "Dl Amazonmusic", "description": "Amazon Music → title guess → full audio match.", "operationId": "dl_amazonmusic_dl_amazonmusic_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/audiomack": {"get": {"tags": ["Downloader"], "summary": "Dl Audiomack", "description": "Audiomack / generic page — yt-dlp extract.", "operationId": "dl_audiomack_dl_audiomack_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/snapany": {"get": {"tags": ["Downloader"], "summary": "Dl Snapany", "description": "SnapAny-style universal downloader (yt-dlp + HubCloud) — unlimited.", "operationId": "dl_snapany_dl_snapany_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/tiktok": {"get": {"tags": ["Downloader"], "summary": "Dl Tiktok", "description": "TikTok video/audio downloader.", "operationId": "dl_tiktok_dl_tiktok_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/ig": {"get": {"tags": ["Downloader"], "summary": "Dl Ig", "description": "Instagram reels / posts downloader.", "operationId": "dl_ig_dl_ig_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/fb": {"get": {"tags": ["Downloader"], "summary": "Dl Fb", "description": "Facebook video downloader.", "operationId": "dl_fb_dl_fb_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/threads": {"get": {"tags": ["Downloader"], "summary": "Dl Threads", "description": "Threads (Meta) media downloader.", "operationId": "dl_threads_dl_threads_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/twitter": {"get": {"tags": ["Downloader"], "summary": "Dl Twitter", "description": "Twitter / X video & GIF downloader.", "operationId": "dl_twitter_dl_twitter_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/ytmp3": {"get": {"tags": ["Downloader"], "summary": "Dl Ytmp3", "description": "YouTube → best audio (mp3/m4a).", "operationId": "dl_ytmp3_dl_ytmp3_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}, {"name": "format", "in": "query", "required": false, "schema": {"type": "string", "description": "mp3|m4a|webm|opus", "default": "m4a", "title": "Format"}, "description": "mp3|m4a|webm|opus"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/ytmp4": {"get": {"tags": ["Downloader"], "summary": "Dl Ytmp4", "description": "YouTube → best video under quality.", "operationId": "dl_ytmp4_dl_ytmp4_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "description": "360|480|720|1080", "default": "720", "title": "Quality"}, "description": "360|480|720|1080"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/soundcloud": {"get": {"tags": ["Downloader"], "summary": "Dl Soundcloud", "operationId": "dl_soundcloud_dl_soundcloud_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/reddit": {"get": {"tags": ["Downloader"], "summary": "Dl Reddit", "operationId": "dl_reddit_dl_reddit_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/pinterest": {"get": {"tags": ["Downloader"], "summary": "Dl Pinterest", "operationId": "dl_pinterest_dl_pinterest_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/tumblr": {"get": {"tags": ["Downloader"], "summary": "Dl Tumblr", "operationId": "dl_tumblr_dl_tumblr_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/twitch": {"get": {"tags": ["Downloader"], "summary": "Dl Twitch", "operationId": "dl_twitch_dl_twitch_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/dailymotion": {"get": {"tags": ["Downloader"], "summary": "Dl Dailymotion", "operationId": "dl_dailymotion_dl_dailymotion_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/vimeo": {"get": {"tags": ["Downloader"], "summary": "Dl Vimeo", "operationId": "dl_vimeo_dl_vimeo_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/capcut": {"get": {"tags": ["Downloader"], "summary": "Dl Capcut", "operationId": "dl_capcut_dl_capcut_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/likee": {"get": {"tags": ["Downloader"], "summary": "Dl Likee", "operationId": "dl_likee_dl_likee_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/snackvideo": {"get": {"tags": ["Downloader"], "summary": "Dl Snackvideo", "operationId": "dl_snackvideo_dl_snackvideo_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/douyin": {"get": {"tags": ["Downloader"], "summary": "Dl Douyin", "operationId": "dl_douyin_dl_douyin_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/snapchat": {"get": {"tags": ["Downloader"], "summary": "Dl Snapchat", "operationId": "dl_snapchat_dl_snapchat_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/bluesky": {"get": {"tags": ["Downloader"], "summary": "Dl Bluesky", "operationId": "dl_bluesky_dl_bluesky_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/rednote": {"get": {"tags": ["Downloader"], "summary": "Dl Rednote", "description": "Xiaohongshu / RedNote.", "operationId": "dl_rednote_dl_rednote_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/9gag": {"get": {"tags": ["Downloader"], "summary": "Dl 9Gag", "operationId": "dl_9gag_dl_9gag_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/hitube": {"get": {"tags": ["Downloader"], "summary": "Dl Hitube", "operationId": "dl_hitube_dl_hitube_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/savevideo": {"get": {"tags": ["Downloader"], "summary": "Dl Savevideo", "description": "Generic save-video / 9xbuddy-style (yt-dlp).", "operationId": "dl_savevideo_dl_savevideo_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/aio": {"get": {"tags": ["Downloader"], "summary": "Dl Aio", "description": "All-in-one downloader (alias of /dl/any).", "operationId": "dl_aio_dl_aio_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/mediafire": {"get": {"tags": ["Downloader"], "summary": "Dl Mediafire", "description": "MediaFire direct link resolver.", "operationId": "dl_mediafire_dl_mediafire_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/gdrive": {"get": {"tags": ["Downloader"], "summary": "Dl Gdrive", "description": "Google Drive — best-effort direct / yt-dlp.", "operationId": "dl_gdrive_dl_gdrive_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/mega": {"get": {"tags": ["Downloader"], "summary": "Dl Mega", "operationId": "dl_mega_dl_mega_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/terabox": {"get": {"tags": ["Downloader"], "summary": "Dl Terabox", "description": "TeraBox / Terabox share link.", "operationId": "dl_terabox_dl_terabox_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/sfile": {"get": {"tags": ["Downloader"], "summary": "Dl Sfile", "operationId": "dl_sfile_dl_sfile_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/sites": {"get": {"tags": ["Downloader"], "summary": "Dl Sites", "operationId": "dl_sites_dl_sites_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/dl/combine": {"get": {"tags": ["Downloader"], "summary": "Dl Combine Get", "description": "Merge video+audio URLs (GET). Prefer POST if URLs are very long.", "operationId": "dl_combine_get_dl_combine_get", "parameters": [{"name": "video", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Video"}}, {"name": "audio", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Audio"}}, {"name": "title", "in": "query", "required": false, "schema": {"type": "string", "default": "video", "title": "Title"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "post": {"tags": ["Downloader"], "summary": "Dl Combine Post", "description": "Merge video+audio via JSON body — avoids long-URL / 502 proxy limits.\n\nBody: `{\"video\":\"https://...\",\"audio\":\"https://...\",\"title\":\"name\"}`", "operationId": "dl_combine_post_dl_combine_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/dl/merged": {"get": {"tags": ["Downloader"], "summary": "Dl Merged", "description": "yt-dlp download+merge. May fail if site blocks bots — use /dl/combine when formats exist.", "operationId": "dl_merged_dl_merged_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 1080, "minimum": 144, "default": 720, "title": "Quality"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/search": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Search", "description": "YouTube Music search (inner API).", "operationId": "ytmusic_search_yt_music_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "filter", "in": "query", "required": false, "schema": {"type": "string", "description": "songs|videos|albums|artists|playlists", "default": "songs", "title": "Filter"}, "description": "songs|videos|albums|artists|playlists"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/home": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Home", "description": "YT Music home / explore rows (via search seeds).", "operationId": "ytmusic_home_yt_music_home_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/yt-music/info": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Info", "description": "Track info from YT Music next endpoint.", "operationId": "ytmusic_info_yt_music_info_get", "parameters": [{"name": "video_id", "in": "query", "required": true, "schema": {"type": "string", "minLength": 6, "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/next": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Next", "description": "Next / radio queue for a track.", "operationId": "ytmusic_next_yt_music_next_get", "parameters": [{"name": "video_id", "in": "query", "required": true, "schema": {"type": "string", "minLength": 6, "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/playlist": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Playlist", "description": "Browse playlist (best-effort via browse endpoint).", "operationId": "ytmusic_playlist_yt_music_playlist_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Playlist id e.g. RDAMVM... or VLPL...", "title": "Id"}, "description": "Playlist id e.g. RDAMVM... or VLPL..."}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/album": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Album", "operationId": "ytmusic_album_yt_music_album_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Browse id MP... or album browseId", "title": "Id"}, "description": "Browse id MP... or album browseId"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/search": {"get": {"tags": ["YouTube"], "summary": "Yt Search", "description": "YouTube video search — Invidious first, YT Music fallback.", "operationId": "yt_search_yt_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/transcript": {"get": {"tags": ["YouTube"], "summary": "Yt Transcript", "description": "YouTube transcript / captions (best-effort).", "operationId": "yt_transcript_yt_transcript_get", "parameters": [{"name": "video_id", "in": "query", "required": true, "schema": {"type": "string", "minLength": 6, "title": "Video Id"}}, {"name": "lang", "in": "query", "required": false, "schema": {"type": "string", "default": "en", "title": "Lang"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/channel": {"get": {"tags": ["YouTube"], "summary": "Yt Channel", "description": "Channel info + latest videos via Invidious.", "operationId": "yt_channel_yt_channel_get", "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string", "description": "Channel id UC... or handle", "title": "Id"}, "description": "Channel id UC... or handle"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/ytaudio": {"get": {"tags": ["YouTube"], "summary": "Yt Ytaudio", "description": "Best audio stream URL (alias of /dl/ytmp3).", "operationId": "yt_ytaudio_yt_ytaudio_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "YouTube URL or video id", "title": "Url"}, "description": "YouTube URL or video id"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/savetube": {"get": {"tags": ["YouTube"], "summary": "Yt Savetube", "description": "YouTube download (native, unlimited) — PaxSenix /yt/savetube compatible shape.", "operationId": "yt_savetube_yt_savetube_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "description": "144|240|360|480|720|1080|mp3", "default": "720", "title": "Quality"}, "description": "144|240|360|480|720|1080|mp3"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/download": {"get": {"tags": ["YouTube"], "summary": "Yt Download", "description": "YouTube audio/video download helper.", "operationId": "yt_download_yt_download_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 6, "title": "Url"}}, {"name": "type", "in": "query", "required": false, "schema": {"type": "string", "description": "audio|video", "default": "audio", "title": "Type"}, "description": "audio|video"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt-music/play/{video_id}": {"get": {"tags": ["YouTube Music"], "summary": "Ytmusic Play", "description": "Play stream for YT Music track.", "operationId": "ytmusic_play_yt_music_play__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/yt/search": {"get": {"tags": ["Music"], "summary": "Music Yt Search", "description": "YouTube / YT Music search — Invidious when up, else YT Music inner API.", "operationId": "music_yt_search_music_yt_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/yt/trending": {"get": {"tags": ["Music"], "summary": "Music Yt Trending", "description": "Trending videos (music-friendly) via Invidious.", "operationId": "music_yt_trending_music_yt_trending_get", "parameters": [{"name": "region", "in": "query", "required": false, "schema": {"type": "string", "default": "US", "title": "Region"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/music/yt/play/{video_id}": {"get": {"tags": ["Music"], "summary": " Innertube Player", "description": "Native YouTube InnerTube player (ANDROID/IOS) — direct googlevideo CDN, no yt-dlp.\n\nReturns {ok, title, thumb, duration, audio_streams, video_streams, formats, provider}", "operationId": "_innertube_player_music_yt_play__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true, "title": "Response  Innertube Player Music Yt Play  Video Id  Get"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/status": {"get": {"tags": ["Anime"], "summary": "Anime Status", "description": "Check if HindiAnime catalog + stream tunnel are reachable.", "operationId": "anime_status_anime_status_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/anime/home": {"get": {"tags": ["Anime"], "summary": "Anime Home", "description": "HindiAnime home sections: airing, popular, latest, movies, genres.", "operationId": "anime_home_anime_home_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/anime/hero": {"get": {"tags": ["Anime"], "summary": "Anime Hero", "description": "HindiAnime hero banners.", "operationId": "anime_hero_anime_hero_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/anime/spotlights": {"get": {"tags": ["Anime"], "summary": "Anime Spotlights", "description": "HindiAnime spotlight rotation.", "operationId": "anime_spotlights_anime_spotlights_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/anime/top10": {"get": {"tags": ["Anime"], "summary": "Anime Top10", "description": "Best-effort top10 from home sections (site top10 may be SPA-only).", "operationId": "anime_top10_anime_top10_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/anime/catalog": {"get": {"tags": ["Anime"], "summary": "Anime Catalog", "description": "Full series + movies catalog from HindiAnime.", "operationId": "anime_catalog_anime_catalog_get", "parameters": [{"name": "type", "in": "query", "required": false, "schema": {"type": "string", "default": "all", "title": "Type"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/search": {"get": {"tags": ["Anime"], "summary": "Anime Search", "description": "Search HindiAnime catalog by title.", "operationId": "anime_search_anime_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/detail/{slug}": {"get": {"tags": ["Anime"], "summary": "Anime Detail", "description": "Episodes list + metadata from /extracted/{slug}.json.", "operationId": "anime_detail_anime_detail__slug__get", "parameters": [{"name": "slug", "in": "path", "required": true, "schema": {"type": "string", "title": "Slug"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/cdn": {"get": {"tags": ["Anime"], "summary": "Anime Cdn", "description": "Direct CDN m3u8 links (VidSrc data API + WASM decrypt + host token).\n\nPrefer this over iframe embeds when you need real playable HLS URLs for VLC / native players.", "operationId": "anime_cdn_anime_cdn_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Tmdb Id"}}, {"name": "title", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Title"}}, {"name": "type", "in": "query", "required": false, "schema": {"type": "string", "description": "series|movie", "default": "series", "title": "Type"}, "description": "series|movie"}, {"name": "season", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Season"}}, {"name": "episode", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Episode"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/play/cdn": {"get": {"tags": ["Play"], "summary": "Play Cdn", "description": "Alias of /anime/cdn for movies & series (same resolver).", "operationId": "play_cdn_play_cdn_get", "parameters": [{"name": "tmdb_id", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Tmdb Id"}}, {"name": "title", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Title"}}, {"name": "type", "in": "query", "required": false, "schema": {"type": "string", "default": "movie", "title": "Type"}}, {"name": "season", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Season"}}, {"name": "episode", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Episode"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/servers": {"get": {"tags": ["Anime"], "summary": "Anime Servers", "description": "All playback servers like hindianime.site watch page (HLS + 13 embeds).\n\nWhen stream tunnel is up: Server 1–3 are native multi-audio HLS.\nAlways: Server 4–16 are embed iframes (VidLink, VidSrc, 2Embed, …) via TMDB id.", "operationId": "anime_servers_anime_servers_get", "parameters": [{"name": "title", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Anime/movie title", "title": "Title"}, "description": "Anime/movie title"}, {"name": "slug", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "hindianime slug", "title": "Slug"}, "description": "hindianime slug"}, {"name": "hash", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "videoHash for native HLS", "title": "Hash"}, "description": "videoHash for native HLS"}, {"name": "type", "in": "query", "required": false, "schema": {"type": "string", "description": "series|movie", "default": "series", "title": "Type"}, "description": "series|movie"}, {"name": "season", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Season"}}, {"name": "episode", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1, "title": "Episode"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/stream": {"get": {"tags": ["Anime"], "summary": "Anime Stream", "description": "Resolve HindiAnime HLS.\n\nHindiAnime serves master on both hosts, but **sub-playlists + segments only work\nwhen stream.hindianime.site Cloudflare Tunnel origin is up**. We always return\n`play_url` through our `/anime/hls` proxy so the browser never hits their tunnel\ndirectly — only our server does.", "operationId": "anime_stream_anime_stream_get", "parameters": [{"name": "hash", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "videoHash from episode", "title": "Hash"}, "description": "videoHash from episode"}, {"name": "url", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "episode page url fallback", "title": "Url"}, "description": "episode page url fallback"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/hls": {"get": {"tags": ["Anime"], "summary": "Anime Hls Proxy", "description": "Proxy m3u8 + segments (CORS). Unwraps HindiAnime segment?url= to CDN when needed.", "operationId": "anime_hls_proxy_anime_hls_get", "parameters": [{"name": "u", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "U"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/anime/tracks": {"get": {"tags": ["Anime"], "summary": "Anime Tracks", "description": "Parse master m3u8 for quality levels + audio tracks (VLC-style list).", "operationId": "anime_tracks_anime_tracks_get", "parameters": [{"name": "hash", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Hash"}}, {"name": "url", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/proxy/mpd": {"get": {"tags": ["MovieBox"], "summary": "Mb Proxy Mpd", "description": "Proxy MPD with CDN cookies and rewrite init/media templates so every\nsegment is fetched via /mb/proxy/segment (cookies applied server-side).\ndash.js can then play without browser Cookie headers.", "operationId": "mb_proxy_mpd_mb_proxy_mpd_get", "parameters": [{"name": "u", "in": "query", "required": true, "schema": {"type": "string", "title": "U"}}, {"name": "cookie", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Cookie"}}, {"name": "referer", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Referer"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/mb/proxy/segment": {"get": {"tags": ["MovieBox"], "summary": "Mb Proxy Segment", "description": "Proxy DASH init/media segment with CDN cookies.", "operationId": "mb_proxy_segment_mb_proxy_segment_get", "parameters": [{"name": "u", "in": "query", "required": true, "schema": {"type": "string", "title": "U"}}, {"name": "cookie", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Cookie"}}, {"name": "referer", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Referer"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/np/videos": {"get": {"tags": ["Netplay"], "summary": "Np Videos", "description": "Netplay **admin** catalog only (Cloudflare Worker + R2 MP4).\n\nThis is NOT MovieBox. IDs are UUIDs, not subject_id.\nMain movies/series still use MovieBox: `/mb/search` → `subject_id` → `/mb/stream/{subject_id}`.\nWorker has no /home or /search — only `/videos`.", "operationId": "np_videos_np_videos_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/np/videos/{video_id}": {"get": {"tags": ["Netplay"], "summary": "Np Detail", "operationId": "np_detail_np_videos__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/np/stream/{video_id}": {"get": {"tags": ["Netplay"], "summary": "Np Stream", "description": "Progressive MP4 — works on every phone.", "operationId": "np_stream_np_stream__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/play-info": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Play Info", "description": "PaxSenix-compatible play-info.\nUpstream still serves HEVC DASH; `url` may be a dummy MP4 notice.\nUse `dash_url` + `headers.Cookie` (or our `/mb/proxy/mpd`).", "operationId": "moviebox_play_info_moviebox_play_info_get", "parameters": [{"name": "subjectId", "in": "query", "required": true, "schema": {"type": "string", "description": "MovieBox subject id", "title": "Subjectid"}, "description": "MovieBox subject id"}, {"name": "season", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Season"}}, {"name": "episode", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Episode"}}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "description": "alias of season", "title": "Se"}, "description": "alias of season"}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "description": "alias of episode", "title": "Ep"}, "description": "alias of episode"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/search": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Search", "description": "PaxSenix-compatible search → direct search/v2.", "operationId": "moviebox_search_moviebox_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/info": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Info", "description": "PaxSenix-compatible title info.", "operationId": "moviebox_info_moviebox_info_get", "parameters": [{"name": "subjectId", "in": "query", "required": true, "schema": {"type": "string", "title": "Subjectid"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/home": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Home", "description": "PaxSenix-compatible home (tab-operating).", "operationId": "moviebox_home_moviebox_home_get", "parameters": [{"name": "tabId", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Tabid"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/list": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox List", "description": "PaxSenix-compatible list (same operating feed).", "operationId": "moviebox_list_moviebox_list_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}, {"name": "perPage", "in": "query", "required": false, "schema": {"type": "integer", "default": 20, "title": "Perpage"}}, {"name": "tabId", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Tabid"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/trending": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Trending", "description": "Trending via tab-operating / search-rank fallback.", "operationId": "moviebox_trending_moviebox_trending_get", "parameters": [{"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/recommendations": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Recommendations", "description": "Related titles (detail-rec).", "operationId": "moviebox_recommendations_moviebox_recommendations_get", "parameters": [{"name": "subjectId", "in": "query", "required": true, "schema": {"type": "string", "title": "Subjectid"}}, {"name": "page", "in": "query", "required": false, "schema": {"type": "integer", "default": 1, "title": "Page"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/moviebox/captions": {"get": {"tags": ["MovieBox-PaxShape"], "summary": "Moviebox Captions", "description": "Subtitles (get-ext-captions).", "operationId": "moviebox_captions_moviebox_captions_get", "parameters": [{"name": "subjectId", "in": "query", "required": true, "schema": {"type": "string", "title": "Subjectid"}}, {"name": "streamId", "in": "query", "required": false, "schema": {"type": "string", "description": "stream id from play-info", "default": "", "title": "Streamid"}, "description": "stream id from play-info"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/play": {"get": {"tags": ["Play"], "summary": "Unified Play", "description": "**Main play API**\n\n| ID | From | Example |\n|----|------|---------|\n| subject_id | `/mb/search` or `/api/search` | 1654274595068805784 |\n| netplay_id | `/np/videos` only | c32891f8-fc0a-… |\n\nMovieBox subject_id is what Netplay app uses for normal movies.\nnetplay_id is a separate admin upload list (few titles, direct MP4).", "operationId": "unified_play_play_get", "parameters": [{"name": "subject_id", "in": "query", "required": false, "schema": {"type": "string", "description": "MovieBox subject_id from /mb/search", "title": "Subject Id"}, "description": "MovieBox subject_id from /mb/search"}, {"name": "netplay_id", "in": "query", "required": false, "schema": {"type": "string", "description": "Only for /np/videos UUID (admin MP4)", "title": "Netplay Id"}, "description": "Only for /np/videos UUID (admin MP4)"}, {"name": "se", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Se"}}, {"name": "ep", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Ep"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/web-search": {"get": {"tags": ["Tools"], "summary": "Tools Web Search", "description": "Web search: DuckDuckGo instant → Wikipedia → DDG lite HTML.", "operationId": "tools_web_search_tools_web_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}, {"name": "max_results", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 20, "minimum": 1, "default": 8, "title": "Max Results"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/google-search": {"get": {"tags": ["Tools"], "summary": "Tools Google Search", "description": "Alias of /tools/web-search (DuckDuckGo-backed, unlimited).", "operationId": "tools_google_search_tools_google_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/gtranslate": {"get": {"tags": ["Tools"], "summary": "Tools Gtranslate", "description": "Translate text (Google gtx → MyMemory fallback, no key).", "operationId": "tools_gtranslate_tools_gtranslate_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Text"}}, {"name": "to", "in": "query", "required": false, "schema": {"type": "string", "description": "Target language code", "default": "en", "title": "To"}, "description": "Target language code"}, {"name": "source", "in": "query", "required": false, "schema": {"type": "string", "description": "Source language or auto", "default": "auto", "title": "Source"}, "description": "Source language or auto"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/tts": {"get": {"tags": ["Tools"], "summary": "Tools Tts", "description": "Google TTS audio URL (streamable).", "operationId": "tools_tts_tools_tts_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "maxLength": 200, "title": "Text"}}, {"name": "lang", "in": "query", "required": false, "schema": {"type": "string", "default": "en", "title": "Lang"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/tts/v2": {"get": {"tags": ["Tools"], "summary": "Tools Tts V2", "operationId": "tools_tts_v2_tools_tts_v2_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "maxLength": 200, "title": "Text"}}, {"name": "lang", "in": "query", "required": false, "schema": {"type": "string", "default": "en", "title": "Lang"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/urlshorter": {"get": {"tags": ["Tools"], "summary": "Tools Urlshorten", "description": "URL shortener via is.gd (free, no key).", "operationId": "tools_urlshorten_tools_urlshorter_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/ssweb": {"get": {"tags": ["Tools"], "summary": "Tools Ssweb", "description": "Website screenshot via free thum.io proxy.", "operationId": "tools_ssweb_tools_ssweb_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}, {"name": "width", "in": "query", "required": false, "schema": {"type": "integer", "default": 1280, "title": "Width"}}, {"name": "height", "in": "query", "required": false, "schema": {"type": "integer", "default": 720, "title": "Height"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/sshtml": {"get": {"tags": ["Tools"], "summary": "Tools Sshtml", "operationId": "tools_sshtml_tools_sshtml_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/quote": {"get": {"tags": ["Tools"], "summary": "Tools Quote", "description": "Random inspirational quote.", "operationId": "tools_quote_tools_quote_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tools/bored": {"get": {"tags": ["Tools"], "summary": "Tools Bored", "description": "Random activity suggestion.", "operationId": "tools_bored_tools_bored_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tools/weather": {"get": {"tags": ["Tools"], "summary": "Tools Weather", "description": "Current weather via wttr.in (no key).", "operationId": "tools_weather_tools_weather_get", "parameters": [{"name": "city", "in": "query", "required": false, "schema": {"type": "string", "default": "Dhaka", "title": "City"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/ip": {"get": {"tags": ["Tools"], "summary": "Tools Ip", "description": "Client IP + geo hint.", "operationId": "tools_ip_tools_ip_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tools/qr": {"get": {"tags": ["Tools"], "summary": "Tools Qr", "description": "QR code image URL (Google Chart API).", "operationId": "tools_qr_tools_qr_get", "parameters": [{"name": "data", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Data"}}, {"name": "size", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 1000, "minimum": 50, "default": 200, "title": "Size"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/base64": {"get": {"tags": ["Tools"], "summary": "Tools Base64", "description": "Base64 encode / decode.", "operationId": "tools_base64_tools_base64_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "title": "Text"}}, {"name": "mode", "in": "query", "required": false, "schema": {"type": "string", "description": "encode|decode", "default": "encode", "title": "Mode"}, "description": "encode|decode"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/hash": {"get": {"tags": ["Tools"], "summary": "Tools Hash", "description": "MD5 / SHA1 / SHA256 of text.", "operationId": "tools_hash_tools_hash_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "title": "Text"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/password": {"get": {"tags": ["Tools"], "summary": "Tools Password", "description": "Secure random password generator.", "operationId": "tools_password_tools_password_get", "parameters": [{"name": "length", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 64, "minimum": 6, "default": 16, "title": "Length"}}, {"name": "symbols", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Symbols"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/uuid": {"get": {"tags": ["Tools"], "summary": "Tools Uuid", "description": "Generate UUID v4.", "operationId": "tools_uuid_tools_uuid_get", "parameters": [{"name": "count", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 20, "minimum": 1, "default": 1, "title": "Count"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/color": {"get": {"tags": ["Tools"], "summary": "Tools Color", "description": "Color info or random palette color.", "operationId": "tools_color_tools_color_get", "parameters": [{"name": "hex", "in": "query", "required": false, "schema": {"type": "string", "description": "e.g. #1a73e8", "title": "Hex"}, "description": "e.g. #1a73e8"}, {"name": "random", "in": "query", "required": false, "schema": {"type": "boolean", "default": false, "title": "Random"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/world-populations": {"get": {"tags": ["Tools"], "summary": "Tools World Pop", "description": "World population snapshot (REST Countries sample).", "operationId": "tools_world_pop_tools_world_populations_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tools/shazam": {"get": {"tags": ["Tools"], "summary": "Tools Shazam", "description": "Song recognition helper via music search (title/lyrics query).", "operationId": "tools_shazam_tools_shazam_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "description": "Song title or lyrics snippet", "title": "Q"}, "description": "Song title or lyrics snippet"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/reels-finder": {"get": {"tags": ["Tools"], "summary": "Tools Reels Finder", "description": "Find Instagram-style reel links via search (metadata only).", "operationId": "tools_reels_finder_tools_reels_finder_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/search-pinterest": {"get": {"tags": ["Tools"], "summary": "Tools Search Pinterest", "operationId": "tools_search_pinterest_tools_search_pinterest_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/search-applestore": {"get": {"tags": ["Tools"], "summary": "Tools Search Appstore", "description": "Apple App Store search (iTunes API, free).", "operationId": "tools_search_appstore_tools_search_applestore_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}, {"name": "country", "in": "query", "required": false, "schema": {"type": "string", "default": "us", "title": "Country"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/vision-color": {"get": {"tags": ["Tools"], "summary": "Tools Vision Color", "description": "Dominant color hint via thum/placeholder (returns suggested palette).", "operationId": "tools_vision_color_tools_vision_color_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "Image URL", "title": "Url"}, "description": "Image URL"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/musixmatch": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Musixmatch", "description": "Fallback: LRCLIB + lyrics.ovh (Musixmatch needs key).", "operationId": "lyrics_musixmatch_lyrics_musixmatch_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/lyrics/spotify": {"get": {"tags": ["Lyrics"], "summary": "Lyrics Platform Alias", "description": "Platform-tagged lyrics → same LRCLIB/OVH stack.", "operationId": "lyrics_platform_alias_lyrics_spotify_get", "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string", "title": "Title"}}, {"name": "artist", "in": "query", "required": false, "schema": {"type": "string", "default": "", "title": "Artist"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/billboard/hot-100": {"get": {"tags": ["Billboard"], "summary": "Billboard Hot100", "description": "Billboard Hot 100 via public chart mirror (best-effort).", "operationId": "billboard_hot100_billboard_hot_100_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/billboard/billboard-200": {"get": {"tags": ["Billboard"], "summary": "Billboard Alias", "operationId": "billboard_alias_billboard_billboard_200_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/spotify/search": {"get": {"tags": ["Spotify"], "summary": "Spotify Search", "description": "Spotify oEmbed + DuckDuckGo assisted search (metadata).", "operationId": "spotify_search_spotify_search_get", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string", "title": "Q"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/spotify/track": {"get": {"tags": ["Spotify"], "summary": "Spotify Track", "operationId": "spotify_track_spotify_track_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/bilibili": {"get": {"tags": ["Downloader"], "summary": "Dl Bilibili", "operationId": "dl_bilibili_dl_bilibili_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/linkedin": {"get": {"tags": ["Downloader"], "summary": "Dl Linkedin", "operationId": "dl_linkedin_dl_linkedin_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/okru": {"get": {"tags": ["Downloader"], "summary": "Dl Okru", "operationId": "dl_okru_dl_okru_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/rumble": {"get": {"tags": ["Downloader"], "summary": "Dl Rumble", "operationId": "dl_rumble_dl_rumble_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/streamable": {"get": {"tags": ["Downloader"], "summary": "Dl Streamable", "operationId": "dl_streamable_dl_streamable_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/bandcamp": {"get": {"tags": ["Downloader"], "summary": "Dl Bandcamp", "operationId": "dl_bandcamp_dl_bandcamp_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/mixcloud": {"get": {"tags": ["Downloader"], "summary": "Dl Mixcloud", "operationId": "dl_mixcloud_dl_mixcloud_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/flickr": {"get": {"tags": ["Downloader"], "summary": "Dl Flickr", "operationId": "dl_flickr_dl_flickr_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/imgur": {"get": {"tags": ["Downloader"], "summary": "Dl Imgur", "operationId": "dl_imgur_dl_imgur_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/xkcd": {"get": {"tags": ["Downloader"], "summary": "Dl Xkcd", "operationId": "dl_xkcd_dl_xkcd_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/bypass-city": {"get": {"tags": ["Tools"], "summary": "Tools Bypass", "description": "Generic link unlock → same as /dl/any.", "operationId": "tools_bypass_tools_bypass_city_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/catalog/all": {"get": {"tags": ["Meta"], "summary": "Catalog All", "description": "Full endpoint map for integrators.", "operationId": "catalog_all_catalog_all_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/health/cookies": {"get": {"tags": ["Meta"], "summary": "Health Cookies", "description": "Show whether YouTube cookies.txt is loaded (does not expose cookie values).", "operationId": "health_cookies_health_cookies_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/youtube/player/{video_id}": {"get": {"tags": ["YouTube"], "summary": "Yt Player", "description": "Direct CDN streams via InnerTube (ANDROID) — no yt-dlp, unlimited.", "operationId": "yt_player_youtube_player__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/yt/player/{video_id}": {"get": {"tags": ["YouTube"], "summary": "Yt Player", "description": "Direct CDN streams via InnerTube (ANDROID) — no yt-dlp, unlimited.", "operationId": "yt_player_yt_player__video_id__get", "parameters": [{"name": "video_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Video Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/youtube": {"get": {"tags": ["Downloader"], "summary": "Dl Youtube Native", "description": "YouTube direct CDN via InnerTube (no yt-dlp). quality=audio for audio-only.", "operationId": "dl_youtube_native_dl_youtube_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "YouTube URL or video id", "title": "Url"}, "description": "YouTube URL or video id"}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "description": "360|480|720|1080|best|audio", "default": "720", "title": "Quality"}, "description": "360|480|720|1080|best|audio"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/dl/yt": {"get": {"tags": ["Downloader"], "summary": "Dl Youtube Native", "description": "YouTube direct CDN via InnerTube (no yt-dlp). quality=audio for audio-only.", "operationId": "dl_youtube_native_dl_yt_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "description": "YouTube URL or video id", "title": "Url"}, "description": "YouTube URL or video id"}, {"name": "quality", "in": "query", "required": false, "schema": {"type": "string", "description": "360|480|720|1080|best|audio", "default": "720", "title": "Quality"}, "description": "360|480|720|1080|best|audio"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/models": {"get": {"tags": ["AI"], "summary": "V1 Models", "description": "List available LLM models (free Pollinations + optional keyed providers).", "operationId": "v1_models_v1_models_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/v1/chat/completions": {"post": {"tags": ["AI"], "summary": "V1 Chat Completions", "description": "OpenAI-compatible chat. Free via Pollinations — no key required.\n\nOptional env for stronger models: GROQ_API_KEY, OPENROUTER_API_KEY, GEMINI_API_KEY\nBody: { model, messages: [{role, content}], system? }", "operationId": "v1_chat_completions_v1_chat_completions_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/v1/{model_id}/chat": {"get": {"tags": ["AI"], "summary": "V1 Model Chat", "description": "Simple GET chat with a model id.", "operationId": "v1_model_chat_v1__model_id__chat_get", "parameters": [{"name": "model_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Model Id"}}, {"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Text"}}, {"name": "system", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai/gemini-realtime": {"get": {"tags": ["AI"], "summary": "Ai Chat Simple", "description": "Unified simple AI chat (PaxSenix-style GET). Free, unlimited via Pollinations.", "operationId": "ai_chat_simple_ai_gemini_realtime_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "description": "prompt", "title": "Text"}, "description": "prompt"}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "openai", "title": "Model"}}, {"name": "system", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai/metaai": {"get": {"tags": ["AI"], "summary": "Ai Chat Simple", "description": "Unified simple AI chat (PaxSenix-style GET). Free, unlimited via Pollinations.", "operationId": "ai_chat_simple_ai_metaai_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "description": "prompt", "title": "Text"}, "description": "prompt"}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "openai", "title": "Model"}}, {"name": "system", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai/deepseek": {"get": {"tags": ["AI"], "summary": "Ai Chat Simple", "description": "Unified simple AI chat (PaxSenix-style GET). Free, unlimited via Pollinations.", "operationId": "ai_chat_simple_ai_deepseek_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "description": "prompt", "title": "Text"}, "description": "prompt"}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "openai", "title": "Model"}}, {"name": "system", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai/chat": {"get": {"tags": ["AI"], "summary": "Ai Chat Simple", "description": "Unified simple AI chat (PaxSenix-style GET). Free, unlimited via Pollinations.", "operationId": "ai_chat_simple_ai_chat_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "description": "prompt", "title": "Text"}, "description": "prompt"}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "openai", "title": "Model"}}, {"name": "system", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "post": {"tags": ["AI"], "summary": "Ai Chat Post", "operationId": "ai_chat_post_ai_chat_post", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/ai-image/sdxl": {"get": {"tags": ["AI Images"], "summary": "Ai Image Generate", "description": "Free AI image generation via Pollinations (Flux etc). No API key.", "operationId": "ai_image_generate_ai_image_sdxl_get", "parameters": [{"name": "prompt", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Prompt"}}, {"name": "text", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Text"}}, {"name": "width", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Width"}}, {"name": "height", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Height"}}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "flux", "title": "Model"}}, {"name": "nologo", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Nologo"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-image/pollinations": {"get": {"tags": ["AI Images"], "summary": "Ai Image Generate", "description": "Free AI image generation via Pollinations (Flux etc). No API key.", "operationId": "ai_image_generate_ai_image_pollinations_get", "parameters": [{"name": "prompt", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Prompt"}}, {"name": "text", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Text"}}, {"name": "width", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Width"}}, {"name": "height", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Height"}}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "flux", "title": "Model"}}, {"name": "nologo", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Nologo"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-image/flux": {"get": {"tags": ["AI Images"], "summary": "Ai Image Generate", "description": "Free AI image generation via Pollinations (Flux etc). No API key.", "operationId": "ai_image_generate_ai_image_flux_get", "parameters": [{"name": "prompt", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Prompt"}}, {"name": "text", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Text"}}, {"name": "width", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Width"}}, {"name": "height", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Height"}}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "flux", "title": "Model"}}, {"name": "nologo", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Nologo"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-image/generate": {"get": {"tags": ["AI Images"], "summary": "Ai Image Generate", "description": "Free AI image generation via Pollinations (Flux etc). No API key.", "operationId": "ai_image_generate_ai_image_generate_get", "parameters": [{"name": "prompt", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Prompt"}}, {"name": "text", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Text"}}, {"name": "width", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Width"}}, {"name": "height", "in": "query", "required": false, "schema": {"type": "integer", "maximum": 2048, "minimum": 256, "default": 1024, "title": "Height"}}, {"name": "model", "in": "query", "required": false, "schema": {"type": "string", "default": "flux", "title": "Model"}}, {"name": "nologo", "in": "query", "required": false, "schema": {"type": "boolean", "default": true, "title": "Nologo"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-image/models": {"get": {"tags": ["AI Images"], "summary": "Ai Image Models", "operationId": "ai_image_models_ai_image_models_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tempmail/create": {"get": {"tags": ["TempMail"], "summary": "Tempmail Create", "description": "Create a temporary email address (Guerrilla Mail).", "operationId": "tempmail_create_tempmail_create_get", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}}}}, "/tempmail/inbox": {"get": {"tags": ["TempMail"], "summary": "Tempmail Inbox", "operationId": "tempmail_inbox_tempmail_inbox_get", "parameters": [{"name": "sid_token", "in": "query", "required": true, "schema": {"type": "string", "description": "from /tempmail/create", "title": "Sid Token"}, "description": "from /tempmail/create"}, {"name": "email", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Email"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tempmail/body": {"get": {"tags": ["TempMail"], "summary": "Tempmail Body", "operationId": "tempmail_body_tempmail_body_get", "parameters": [{"name": "sid_token", "in": "query", "required": true, "schema": {"type": "string", "title": "Sid Token"}}, {"name": "message_id", "in": "query", "required": true, "schema": {"type": "string", "description": "mail_id from inbox", "title": "Message Id"}, "description": "mail_id from inbox"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/urlshorten": {"get": {"tags": ["Tools"], "summary": "Tools Urlshorten", "description": "URL shortener via is.gd (free, no key).", "operationId": "tools_urlshorten_tools_urlshorten_get", "parameters": [{"name": "url", "in": "query", "required": true, "schema": {"type": "string", "minLength": 8, "title": "Url"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/tools/whois": {"get": {"tags": ["Tools"], "summary": "Tools Whois", "description": "Simple DNS lookup.", "operationId": "tools_whois_tools_whois_get", "parameters": [{"name": "domain", "in": "query", "required": true, "schema": {"type": "string", "minLength": 3, "title": "Domain"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-tools/summarize": {"get": {"tags": ["AI Tools"], "summary": "Ai Summarize", "operationId": "ai_summarize_ai_tools_summarize_get", "parameters": [{"name": "input", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Input"}}, {"name": "length", "in": "query", "required": false, "schema": {"type": "string", "default": "medium", "title": "Length"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/ai-tools/tone-rewrite": {"get": {"tags": ["AI Tools"], "summary": "Ai Tone Rewrite", "operationId": "ai_tone_rewrite_ai_tools_tone_rewrite_get", "parameters": [{"name": "text", "in": "query", "required": true, "schema": {"type": "string", "minLength": 1, "title": "Text"}}, {"name": "tone", "in": "query", "required": false, "schema": {"type": "string", "default": "professional", "title": "Tone"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/site": {"get": {"tags": ["Meta"], "summary": "Site Spa", "operationId": "site_spa_site_get", "responses": {"200": {"description": "Successful Response", "content": {"text/html": {"schema": {"type": "string"}}}}}}}}, "components": {"schemas": {"HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}}}}