api doc change

app.py

@@ -3,7 +3,7 @@ from flask import *
 from flask_limiter import Limiter
 from flask_limiter.util import get_remote_address
 
-from routes.helpers import checkSignature
+from routes.helpers import checkSignature, configFile
 from routes import *
 
 app = Flask(__name__)
@@ -84,5 +84,17 @@ def getBMPreview(): return osuApi.getPreview(request)
 def getBMFull(): return osuApi.getFull(request)
 
 if __name__ == "__main__":
+    VERSION = '1.0 build70'
+    
+    config = configFile()
+    with open(config['config-path'], "w") as outfile:
+        config['buildVersion'] = VERSION
+        json.dump(config, outfile)
+    with open(config['openapi-yaml-path'], "r+w") as outfile:
+        info = outfile.read()
+        outfile.seek(0)
+        outfile.write(info.replace('$VERSION_VARIABLE$', VERSION))
+        outfile.truncate()
+    
     app.run(host="0.0.0.0", port=7860)
 

routes/config.json

@@ -1,9 +1,15 @@
 {
 	"url": "https://imperialwool-funapi.hf.space",
+	
 	"full-path": "/app/static/full",
 	"temp-path": "/app/static/temp",
 	"static-path": "/app/static",
 	"previews-path": "/app/static/previews",
+	
+	"config-path": "/app/routes/config.json",
+	"openapi-yaml-path": "/app/static/api.yaml",
+	
 	"signatures-db": "/app/signatures.db",
-	"buildVersion": "1.0 build62"
+	
+	"buildVersion": "1.0 build63"
 }

routes/osuApi/getFull.py

@@ -44,7 +44,7 @@ def getFull(request):
     if query != None:
         fffff = findSong(request)
         if fffff['status'] == "error": return fffff
-        beatmapId = fffff['details']['result'][rand(0,len(fffff['details']['result']))]['beatmapId']
+        beatmapId = fffff['details']['result'][rand(0,len(fffff['details']['result'])-1)]['beatmapId']
         if os.path.exists(f"{config['full-path']}/{beatmapId}.ogg"):
             return {"status": "pass", "details": {"code": 200, "result": f"{config['url']}/static/full/{beatmapId}.ogg"}}
         tryment = get(f"https://kitsu.moe/api/audio/{beatmapId}", allow_redirects=True)
@@ -54,7 +54,7 @@ def getFull(request):
             audio_output = ffmpeg.output(audio_input, f"{config['full-path']}/{beatmapId}.ogg", audio_bitrate="96K")
             ffmpeg.run(audio_output)
             helpers.deleteAudio(f"temp/{beatmapId}.ogg")
-            return {"status": "pass", "details": {"code": int(tryment.status_code), "result": f"{config['url']}/static/full/{beatmapId}.ogg"}}
+            return {"status": "pass", "details": {"code": int(tryment.status_code), "name": f"{beatmapId}.ogg", "result": f"{config['url']}/static/full/{beatmapId}.ogg"}}
         else: 
             return {"status": "error", "details": {"code": int(tryment.status_code), "answer": tryment.text}}
     return {}

routes/osuApi/getPreview.py

@@ -34,5 +34,6 @@ def getPreview(request):
     if query != None:
         fffff = findSong(request)
         if fffff['status'] == "error": return fffff
-        return {"status": "pass", "details": {"code": fffff['details']['code'], "result": "https://b.ppy.sh/preview/{}.mp3".format(fffff['details']['result'][rand(0,len(fffff['details']['result']))]['beatmapId'])}}
+        rBId = fffff['details']['result'][rand(0,len(fffff['details']['result'])-1)]['beatmapId']
+        return {"status": "pass", "details": {"code": fffff['details']['code'], "name": "{rBId}.mp3", "result": f"https://b.ppy.sh/preview/{rBId}.mp3"}}
     return {}

routes/siteRoutes/sigGen.py

@@ -23,7 +23,7 @@ def signatureGen(request):
     query = db.query(f"INSERT INTO `table` (`key`, `endtime`, `creatorKey`) VALUES (\"{key}\", \"{endtime}\", \"{creatorKey}\")")
     
     if query['status']:
-        return {"status": "ok", "result": key, "endtime": endtime}
+        return {"status": "pass", "result": key, "endtime": endtime}
     else:
         return {"status": "error", "details": {"error_code": -1, "error_details": "This key already got signature"}}
     

routes/witaiApi/recognizeVoice.py

@@ -36,10 +36,10 @@ def recognizeVoice(request):
             resp = e
     helpers.deleteAudio(f"temp/{fileId}{fileExt}")
     try:
-        if resp['text'] == "": return {"status": "ok", "result": "", "details": ""}
+        if resp['text'] == "": return {"status": "pass", "result": "", "details": ""}
     except: pass
     if noEx:
         
-        if extendInfo: return {"status": "ok", "result": helpers.delivering(resp), "details": str(helpers.devRaw(resp))}
-        else: return {"status": "ok", "result": helpers.delivering(resp)}
+        if extendInfo: return {"status": "pass", "result": helpers.delivering(resp), "details": str(helpers.devRaw(resp))}
+        else: return {"status": "pass", "result": helpers.delivering(resp)}
     else: return {"status": "error", "details": { "error_code": 123, "error_details": resp }}

static/api.yaml

@@ -1,14 +1,268 @@
 openapi: 3.0.0
 info:   
   title: woolbot's FunAPI
-  description:  Collection of APIs for bots or just fun by @podvaljoey.
-  version: 0.1.103
+  description: Big API for bots, developers or just fun by @podvaljoey.
+  version: $VERSION_VARIABLE$
 servers:
   - url: 'https://imperialwool-funapi.hf.space/'
-    description: First path, public.
-  - url: 'https://funapi.dnszilla.bar/'
-    description: Second path, private. 
+    description: 'You are here! ^з^'
 paths:
+  /signatures/api/v1/get:
+    get:
+        tags:
+            - "Authentication"
+        parameters:
+            - name: 'key'
+              description: Key to generate signature.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+        summary: "Generating auth key with small TTL."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/AuthSuccessObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/AuthErrorObject"
+    post:
+        tags:
+            - "Authentication"
+        parameters:
+            - name: 'key'
+              description: Key to generate signature.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+        summary: "Generating auth key with small TTL."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/AuthSuccessObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/AuthErrorObject"
+  /osu/api/v1/find-song:
+    get:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Finding beatmap by query."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/FindBeatmapsObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Finding beatmap by query."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/FindBeatmapsObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+  /osu/api/v1/get-full:
+    get:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap and download full song.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'beatmapId'
+              description: Beatset id. Not map, set.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 1
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Get beatmap's full song."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SongFullObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap and download full song.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'beatmapId'
+              description: Beatset id. Not map, set.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 1
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Get beatmap's full song."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SongFullObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+  /osu/api/v1/get-preview:
+    get:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap and download full song.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'beatmapId'
+              description: Beatset id. Not map, set.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 1
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Get beatmap's song preview."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SongPreviewObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "osu! API"
+        parameters:
+            - name: 'query'
+              description: Query to find beatmap and download full song.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: rickroll
+            - name: 'beatmapId'
+              description: Beatset id. Not map, set.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 1
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Get beatmap's song preview."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SongPreviewObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
   /recognize/api/v1/voice:
     get:
         tags:
@@ -32,6 +286,7 @@ paths:
               in: 'query'
               schema:
                 type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
         summary: "This method can help with converting voice into the text."
         responses:
           200:
@@ -39,7 +294,7 @@ paths:
             content:
               application/json:
                 schema:
-                  $ref: "#/components/schemas/RecognizeResult"
+                  $ref: "#/components/schemas/RecognizeObject"
           400:
             description: Bad Request
             content:
@@ -73,6 +328,7 @@ paths:
               in: 'query'
               schema:
                 type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
         summary: "This method can help with converting voice into the text."
         responses:
           200:
@@ -80,7 +336,42 @@ paths:
             content:
               application/json:
                 schema:
-                  $ref: "#/components/schemas/RecognizeResult"
+                  $ref: "#/components/schemas/RecognizeObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+  /system-info/api/v1/get:
+    get:
+        tags:
+            - "System information"
+        summary: "Information about server."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SysinfoObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "System information"
+        summary: "Information about server."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/SysinfoObject"
           400:
             description: Bad Request
             content:
@@ -103,6 +394,7 @@ paths:
               in: 'query'
               schema:
                 type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
         summary: "This method can help with searching videos on YouTube."
         responses:
           200:
@@ -110,7 +402,7 @@ paths:
             content:
               application/json:
                 schema:
-                  $ref: "#/components/schemas/YTSearchResult"
+                  $ref: "#/components/schemas/YTSearchObject"
           400:
             description: Bad Request
             content:
@@ -132,6 +424,7 @@ paths:
               in: 'query'
               schema:
                 type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
         summary: "This method can help with searching videos on YouTube."
         responses:
           200:
@@ -139,7 +432,185 @@ paths:
             content:
               application/json:
                 schema:
-                  $ref: "#/components/schemas/YTSearchResult"
+                  $ref: "#/components/schemas/YTSearchObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"        
+  /yt/api/v1/get-full:
+    get:
+        tags:
+            - "Youtube: Becoming Music Platform"
+        parameters:
+            - name: 'url'
+              description: Url to video from YouTube. (TikTok also works sometimes.)
+              in: 'query'
+              schema:
+                type: 'string'
+            - name: 'bitrate'
+              description: Bitrate of final audio.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "64k"
+            - name: 'quality'
+              description: Quality of final audio. Only 'worst' or 'best'.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "worst"
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Download video as audio and providing link for you."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/YTFullObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "Youtube: Becoming Music Platform"
+        parameters:
+            - name: 'url'
+              description: Url to video from YouTube. (TikTok also works sometimes.)
+              in: 'query'
+              schema:
+                type: 'string'
+            - name: 'bitrate'
+              description: Bitrate of final audio.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "64k"
+            - name: 'quality'
+              description: Quality of final audio. Only 'worst' or 'best'.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "worst"
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Download video as audio and providing link for you."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/YTFullObject"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+  /yt/api/v1/get-preview:
+    get:
+        tags:
+            - "Youtube: Becoming Music Platform"
+        parameters:
+            - name: 'url'
+              description: Url to video from YouTube. (TikTok also works sometimes.)
+              in: 'query'
+              schema:
+                type: 'string'
+            - name: 'bitrate'
+              description: Bitrate of final audio.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "64k"
+            - name: 'quality'
+              description: Quality of final audio. Only 'worst' or 'best'.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "worst"
+            - name: 'duration'
+              description: Duration of preview. Maximum 60 seconds.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 30
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Download video as cutted audio and providing link for you."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/YTPreviewResult"
+          400:
+            description: Bad Request
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/ErrorObject"
+    post:
+        tags:
+            - "Youtube: Becoming Music Platform"
+        parameters:
+            - name: 'url'
+              description: Url to video from YouTube. (TikTok also works sometimes.)
+              in: 'query'
+              schema:
+                type: 'string'
+            - name: 'bitrate'
+              description: Bitrate of final audio.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "64k"
+            - name: 'quality'
+              description: Quality of final audio. Only 'worst' or 'best'.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: "worst"
+            - name: 'duration'
+              description: Duration of preview. Maximum 60 seconds.
+              in: 'query'
+              schema:
+                type: 'integer'
+              example: 30
+            - name: 'signature'
+              description: Special access key.
+              in: 'query'
+              schema:
+                type: 'string'
+              example: 'B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B'
+        summary: "Download video as cutted audio and providing link for you."
+        responses:
+          200:
+            description: OK
+            content:
+              application/json:
+                schema:
+                  $ref: "#/components/schemas/YTPreviewResult"
           400:
             description: Bad Request
             content:
@@ -148,6 +619,155 @@ paths:
                   $ref: "#/components/schemas/ErrorObject"
 components:
   schemas:
+    SongFullObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        details:
+          type: object
+          properties:
+            code:
+              type: integer
+              example: 200
+            name:
+              type: string
+              example: "1592415.ogg"
+            result:
+              type: string
+              example: "https://imperialwool-funapi.hf.space/static/full/1592415.ogg"
+    SongPreviewObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        details:
+          type: object
+          properties:
+            code:
+              type: integer
+              example: 200
+            name:
+              type: string
+              example: "1244874.mp3"
+            result:
+              type: string
+              example: "https://b.ppy.sh/preview/1244874.mp3"
+    BeatmapObject:
+      type: object
+      properties:
+        "artist":
+          type: string
+          example: "never gonna give you up remix"
+        "beatmapId":
+          type: integer
+          example: 1542795
+        "creator":
+          type: string
+          example: "CrisFloppa"
+        "source": 
+          type: string
+          example: ""
+        "tags":
+          type: string
+          example: "never gonna gie you up rick roll"
+        "title": 
+          type: string
+          example: "rick astley"
+    FindBeatmapsObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        details:
+          type: object
+          properties:
+            "code":
+              type: integer
+              example: 200
+            "result":
+              type: array
+              items:
+                $ref: "#/components/schemas/BeatmapObject"
+    SysinfoObject:
+      type: object
+      properties:
+        "API_VERSION":
+          type: string
+          example: "1.0 build62"
+        "CPU_INFO":
+          type: object
+          properties:
+            "cpu_brand":
+              type: string
+              example: "AMD EPYC 7R13 Processor"
+            "cpu_count":
+              type: object
+              properties:
+                "all":
+                  type: integer
+                  example: 16
+                "exclude_virtual":
+                  type: integer
+                  example: 8
+            "cpu_freq":
+              type: object
+              properties:
+                "current":
+                  type: number
+                  format: float
+                  example: 3522.9323125
+                "min":
+                  type: number
+                  format: float
+                  example: 0.0
+                "max":
+                  type: number
+                  format: float
+                  example: 3600.0
+            "cpu_load":
+              type: number
+              format: float
+              example: 16.2
+        "MEM_INFO":
+          type: object
+          properties:
+            "mem_total":
+              type: integer
+              example: 126125
+            "mem_used":
+              type: integer
+              example: 87497
+    AuthSuccessObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        endtime:
+          type: integer
+          example: 1672602259
+        result:
+          type: string
+          example: B46AAB1A3F1E33625C1B6BD9507453B928DE69BA638E7098DB533A2184ED288EFB899D563EF8AB5487DACBCAD909A801E4C81FD6D34B639F6591295CD1D10A5B
+    AuthErrorObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: error
+        details:
+          type: object
+          properties:
+            error_code:
+              type: integer
+              example: -1
+            error_details:
+              type: string
+              example: This key already got signature
     ErrorObject:
       type: object
       properties:
@@ -158,21 +778,21 @@ components:
           type: object
           properties:
             error_code:
-              type: int
+              type: integer
               example: 103
             error_details:
               type: string
               example: No signature
-    RecognizeResult:
+    RecognizeObject:
       type: object
       properties:
         status:
           type: string
-          example: ok
+          example: pass
         result:
           type: string
           example: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean condimentum neque quis enim bibendum, ut molestie magna gravida. Donec et felis eget lacus sodales convallis. Quisque vitae erat et leo lobortis iaculis. Maecenas a lectus vitae metus fringilla luctus. Morbi sed pellentesque elit. Phasellus bibendum et urna sed elementum. Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus."
-    YTSearchResult:
+    YTSearchObject:
       type: object
       properties:
         status:
@@ -192,4 +812,40 @@ components:
               example: GtL1huin9EE
             "2":
               type: string
-              example: uXV-IaR_vNE
+              example: uXV-IaR_vNE
+    YTFullObject:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        details:
+          type: object
+          properties:
+            code:
+              type: integer
+              example: 0
+            name:
+              type: string
+              example: "R8YprjS6ztg.ogg"
+            result:
+              type: string
+              example: "https://imperialwool-funapi.hf.space/static/full/R8YprjS6ztg.ogg"
+    YTPreviewResult:
+      type: object
+      properties:
+        status:
+          type: string
+          example: pass
+        details:
+          type: object
+          properties:
+            code:
+              type: integer
+              example: 0
+            name:
+              type: string
+              example: "R8YprjS6ztg.ogg"
+            result:
+              type: string
+              example: "https://imperialwool-funapi.hf.space/static/previews/R8YprjS6ztg.ogg"