Task: Video Effects - Single Image

Description: The following content preserves the original OpenAPI specification in full, with minimal formatting applied and all fields and descriptions retained.

---

Original OpenAPI Specification

openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /kling/v1/videos/effects:
    post:
      summary: Task: Video Effects - Single Image
      deprecated: false
      description: ''
      tags:
        - Video Models (Video) / Kuaishou Keling AI
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              title: General request body
              description: |-
                Different effect scenes are implemented based on effect_scene.
                - Single-image effects: fuzzyfuzzy, squish, expansion
                - Dual interaction effects: hug, kiss, heart_gesture
              type: object
              properties:
                effect_scene:
                  type: string
                  title: Scene name
                  description: Effect scene name
                  enum:
                    - fuzzyfuzzy
                    - squish
                    - expansion
                input:
                  title: Task input structure
                  description: Supports different task input structures. The specific fields vary by scene.
                  type: object
                  properties:
                    duration:
                      type: string
                      title: Video duration
                      description: In seconds
                      enum:
                        - '5'
                    image:
                      type: string
                      description: >-
                        Reference image

                        Supports Base64 or URL.

                        Note: If using Base64, the string must not include a `data:` prefix.
                        Image formats support .jpg / .jpeg / .png.
                        File size must be <=10MB, resolution >=300x300px, aspect ratio within 1:2.5~2.5:1.
                    model_name:
                      type: string
                      title: Model name
                      description: Note: Single-image effects only support `kling-v1-6`
                      enum:
                        - kling-v1-6
                  required:
                    - duration
                    - image
                    - model_name
                callback_url:
                  title: Task result callback URL
                  description: >-
                    If configured, the server will proactively notify the task status changes.
                    The message schema is defined by the Callback Protocol.
                  type: string
                external_task_id:
                  title: Custom task ID
                  description: User-defined task ID. It will not replace the system-generated ID, but can be used for task queries. Must be unique per user.
                  type: string
            example:
              effect_scene: expansion
              input:
                model_name: kling-v1-6
                image: >-
                  https://p1-kling.klingai.com/bs2/upload-ylab-stunt/kling/ai_se/%E8%86%A8%E8%83%80case-%E8%B7%AF%E4%B8%8A%E7%BA%A2%E8%89%B2%E6%B1%BD%E8%BD%A6.jpg?x-kcdn-pid=112452&x-oss-process=image
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                  request_id:
                    type: string
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                      task_status:
                        type: string
                      created_at:
                        type: integer
                      updated_at:
                        type: integer
                      task_result:
                        type: object
                        properties:
                          images:
                        required:
                          - images
                          - videos
                      task_status_msg:
                        type: string
                      action:
                        type: string
                      status:
                        type: string
                      fail_reason:
                        type: string
                      submit_time:
                        type: integer
                      start_time:
                        type: integer
                      finish_time:
                        type: integer
                      progress:
                        type: string
                      data:
                        type: object
                        properties:
                          task_id:
                        required:
                    required:
                      - task_id
                      - task_status
                      - created_at
                      - updated_at
                      - task_result
                      - task_status_msg
                      - action
                      - status
                      - fail_reason
                      - submit_time
                      - start_time
                      - finish_time
                      - progress
                      - data
          security:
            - bearer: []
          x-apifox-folder: Video Models (Video) / Kuaishou Keling AI
servers:
  - url: https://api.gpt.ge
    description: production
security:
  - bearer: []