feat 新增接口描述 docs页面 ，新增S3 图片get upload 操作，整理代码

fix

app/api/api_attribute_retrieve.py

@@ -1,5 +1,6 @@
 import json
 import logging
+
 from fastapi import APIRouter, HTTPException
 
 from app.core.config import DEBUG
@@ -16,6 +17,22 @@ logger = logging.getLogger()
 # 属性识别
 @router.post("/attribute_recognition", response_model=ResponseModel)
 def attribute_recognition(request_item: list[AttributeRecognitionModel]):
+    """
+        获取sketch的属性，collar sleeve_length 等等
+        创建一个具有以下参数的请求体:
+        - **category**: sketch的类别 ，Dress
+        - **colony**: 服装类别，男装或女装
+        - **sketch_img_url**: 被提取属性的S3或minio url地址
+
+        示例参数：
+        [
+            {
+                "category": "Dress",
+                "colony": "Female",
+                "sketch_img_url": "aida-users/89/sketchboard/female/Dress/ae976103-d7ec-4eed-b5d1-3e5f04d8be26.jpg"
+            }
+        ]
+    """
     try:
         logger.info(f"attribute_recognition request item is : @@@@@@:{request_item}")
         if DEBUG:
@@ -33,6 +50,20 @@ def attribute_recognition(request_item: list[AttributeRecognitionModel]):
 # 类别识别
 @router.post("/category_recognition")
 def category_recognition(request_item: list[CategoryRecognitionModel]):
+    """
+        获取sketch的类别，dress blouse 等等
+        创建一个具有以下参数的请求体:
+        - **colony**: 服装类别，male或Female
+        - **sketch_img_url**: 被提取sketch类别的S3或minio url地址
+
+        示例参数：
+        [
+            {
+                "colony": "Female",
+                "sketch_img_url": "aida-users/89/sketchboard/female/Dress/ae976103-d7ec-4eed-b5d1-3e5f04d8be26.jpg"
+            }
+        ]
+    """
     try:
         logger.info(f"category_recognition request item is : @@@@@@:{request_item}")
         service = CategoryRecognition(request_data=request_item)