docs(api): 同步模型权限与 Kling 接口契约

apps/api/docs/swagger.yaml

@@ -393,6 +393,125 @@ definitions:
         example: easyai-ai-gateway
         type: string
     type: object
+  httpapi.KelingCompatibleEnvelope:
+    properties:
+      code:
+        example: 0
+        type: integer
+      data: {}
+      message:
+        example: SUCCEED
+        type: string
+      request_id:
+        type: string
+    type: object
+  httpapi.KelingOmniElementInput:
+    properties:
+      element_id: {}
+    type: object
+  httpapi.KelingOmniImageInput:
+    properties:
+      image_url:
+        type: string
+      type:
+        enum:
+        - first_frame
+        - end_frame
+        type: string
+    type: object
+  httpapi.KelingOmniMultiPrompt:
+    properties:
+      duration:
+        example: "3"
+        type: string
+      index:
+        example: 1
+        type: integer
+      prompt:
+        example: A wide establishing shot
+        type: string
+    type: object
+  httpapi.KelingOmniVideoInput:
+    properties:
+      keep_original_sound:
+        enum:
+        - "yes"
+        - "no"
+        type: string
+      refer_type:
+        enum:
+        - base
+        - feature
+        type: string
+      video_url:
+        type: string
+    type: object
+  httpapi.KelingOmniVideoRequest:
+    properties:
+      aspect_ratio:
+        enum:
+        - "16:9"
+        - "9:16"
+        - "1:1"
+        example: "9:16"
+        type: string
+      callback_url:
+        type: string
+      duration:
+        example: "5"
+        type: string
+      element_list:
+        items:
+          $ref: '#/definitions/httpapi.KelingOmniElementInput'
+        type: array
+      external_task_id:
+        type: string
+      image_list:
+        items:
+          $ref: '#/definitions/httpapi.KelingOmniImageInput'
+        type: array
+      mode:
+        enum:
+        - std
+        - pro
+        - 4k
+        example: pro
+        type: string
+      model_name:
+        example: kling-v3-omni
+        type: string
+      multi_prompt:
+        items:
+          $ref: '#/definitions/httpapi.KelingOmniMultiPrompt'
+        type: array
+      multi_shot:
+        example: false
+        type: boolean
+      prompt:
+        example: A quiet street in the rain with natural ambient sound
+        type: string
+      shot_type:
+        example: customize
+        type: string
+      sound:
+        enum:
+        - "on"
+        - "off"
+        example: "on"
+        type: string
+      video_list:
+        items:
+          $ref: '#/definitions/httpapi.KelingOmniVideoInput'
+        type: array
+      watermark_info:
+        $ref: '#/definitions/httpapi.KelingOmniWatermarkInfo'
+    type: object
+  httpapi.KelingOmniWatermarkInfo:
+    properties:
+      enabled:
+        example: false
+        type: boolean
+    type: object
   httpapi.ModelCatalogFilterOption:
     properties:
       count:
@@ -909,6 +1028,12 @@ definitions:
     type: object
   httpapi.TaskRequest:
     properties:
+      aspect_ratio:
+        example: "16:9"
+        type: string
+      audio:
+        example: false
+        type: boolean
       audioWeight:
         example: 0.65
         type: number
@@ -1005,6 +1130,9 @@ definitions:
       vol:
         example: 1
         type: number
+      watermark:
+        example: false
+        type: boolean
       weirdnessConstraint:
         example: 0.35
         type: number
@@ -6408,6 +6536,33 @@ paths:
       summary: 批量写入 API Key 访问规则
       tags:
       - api-keys
+  /api/v1/api-keys/assignable-models:
+    get:
+      description: 按当前用户自身的用户、租户和用户组权限返回可分配给 API Key 的启用模型，不受任何 API Key 权限规则影响。
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/httpapi.PlatformModelListResponse'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/httpapi.ErrorEnvelope'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/httpapi.ErrorEnvelope'
+        "503":
+          description: Service Unavailable
+          schema:
+            $ref: '#/definitions/httpapi.ErrorEnvelope'
+      security:
+      - BearerAuth: []
+      summary: 列出 API Key 可分配模型
+      tags:
+      - api-keys
   /api/v1/auth/login:
     post:
       consumes:
@@ -9904,6 +10059,92 @@ paths:
       summary: 取消异步任务
       tags:
       - tasks
+  /v1/videos/omni-video:
+    post:
+      consumes:
+      - application/json
+      description: 兼容 Kling 旧版 /v1/videos/omni-video；Bearer token 必须为 Gateway API
+        Key。任务固定异步执行，返回的 task_id 为网关任务 ID。
+      parameters:
+      - description: Kling Omni 官方兼容请求
+        in: body
+        name: input
+        required: true
+        schema:
+          $ref: '#/definitions/httpapi.KelingOmniVideoRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "429":
+          description: Too Many Requests
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "503":
+          description: Service Unavailable
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+      security:
+      - BearerAuth: []
+      summary: 创建 Kling Omni 视频任务
+      tags:
+      - kling-compatible
+  /v1/videos/omni-video/{taskID}:
+    get:
+      description: 按创建接口返回的网关 task_id 查询任务；仅允许创建任务的 Gateway 用户访问。
+      parameters:
+      - description: 网关任务 ID
+        in: path
+        name: taskID
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "401":
+          description: Unauthorized
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "403":
+          description: Forbidden
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "404":
+          description: Not Found
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/httpapi.KelingCompatibleEnvelope'
+      security:
+      - BearerAuth: []
+      summary: 查询 Kling Omni 视频任务
+      tags:
+      - kling-compatible
   /v1/voice_clone:
     post:
       consumes: