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

fix

app/api/api_generate_image.py

@@ -18,6 +18,25 @@ logger = logging.getLogger()
 
 @router.post("/generate_image")
 def generate_image(request_item: GenerateImageModel, background_tasks: BackgroundTasks):
+    """
+        创建一个具有以下参数的请求体:
+        - **tasks_id**: 任务id 用于取消生成任务和获取生成结果
+        - **prompt**: 想要生成图片的描述词
+        - **image_url**: 图生图的输入，minio或S3 url 地址
+        - **mode**: 生成模式，img2img或者txt2img
+        - **category**: 生成图片的类别，sketch print 等等
+        - **gender**: 生成sketch专用，服装类别
+
+        示例参数：
+        {
+          "tasks_id": "123-89",
+          "prompt": "skeleton sitting by the side of a river looking soulful, concert poster, 4k, artistic",
+          "image_url": "aida-collection-element/87/Printboard/842c09cf-7297-42d9-9e6e-9c17d4a13cb5.jpg",
+          "mode": "img2img",
+          "category": "sketch",
+          "gender": "male"
+        }
+    """
     try:
         logger.info(f"generate_image request item is : @@@@@@:{request_item}")
         service = GenerateImage(request_item)
@@ -45,6 +64,19 @@ def generate_image(tasks_id: str):
 
 @router.post("/generate_single_logo")
 def generate_single_logo(request_item: GenerateSingleLogoImageModel, background_tasks: BackgroundTasks):
+    """
+        创建一个具有以下参数的请求体:
+        - **tasks_id**: 任务id 用于取消生成任务和获取生成结果
+        - **prompt**: 想要生成图片的描述词
+        - **seed**: 固定的prompt和固定的seed 每次的生成结果都是一样的
+
+        示例参数：
+        {
+          "tasks_id": "123-89",
+          "prompt": "an apple",
+          "seed": "2"
+        }
+    """
     try:
         logger.info(f"generate_single_logo request item is : @@@@@@:{request_item}")
         service = GenerateSingleLogoImage(request_item)
@@ -72,6 +104,19 @@ def generate_single_logo_image(tasks_id: str):
 
 @router.post("/generate_product_image")
 def generate_product_image(request_item: GenerateProductImageModel, background_tasks: BackgroundTasks):
+    """
+        创建一个具有以下参数的请求体:
+        - **tasks_id**: 任务id 用于取消生成任务和获取生成结果
+        - **prompt**: 想要生成图片的描述词
+        - **image_url**: 被生成图片的S3或minio url地址
+
+        示例参数：
+        {
+          "tasks_id": "123-89",
+          "prompt": "the best quality, masterpiece. detailed, high-res, simple background, studio photography, extremely detailed, updo, detailed face, face, close-up, HDR, UHD, 8K realistic, Highly detailed, simple background, Studio lighting",
+          "image_url": "aida-results/result_00097282-ebb2-11ee-a822-b48351119060.png"
+        }
+    """
     try:
         logger.info(f"generate_product_image request item is : @@@@@@:{request_item}")
         service = GenerateProductImage(request_item)
@@ -99,6 +144,19 @@ def generate_product_image(tasks_id: str):
 
 @router.post("/generate_relight_image")
 def generate_relight_image(request_item: GenerateProductImageModel, background_tasks: BackgroundTasks):
+    """
+        创建一个具有以下参数的请求体:
+        - **tasks_id**: 任务id 用于取消生成任务和获取生成结果
+        - **prompt**: 想要生成图片的描述词
+        - **image_url**: 被生成图片的S3或minio url地址
+
+        示例参数：
+        {
+          "tasks_id": "123-89",
+          "prompt": "beautiful woman, detailed face, sunshine, outdoor, warm atmosphere",
+          "image_url": "aida-sys-image/images/female/blouse/0628000098.jpg"
+        }
+    """
     try:
         logger.info(f"generate_relight_image request item is : @@@@@@:{request_item}")
         service = GenerateRelightImage(request_item)