众扬汇 AI 开放平台 API 文档

多模态视频编辑 (删减视频选区)

接口:POST /kling/v1/videos/multi-elements/delete-selection 归属:快手可灵(官方格式) 调用地址:Base URL https://api.allyang.cn(OpenAI 兼容前缀 https://api.allyang.cn/v1)+ 上述路径 鉴权:请求头 Authorization: Bearer <你的令牌>;令牌在控制台「令牌管理」创建 说明:下方为本接口契约。路径、字段名与枚举取值与线上接口一致;叙述文字已按本平台口径重写。价格、并发与限流等数值以控制台及实际返回为准,未确认处标注「待补」。

OpenAPI Specification

yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /kling/v1/videos/multi-elements/delete-selection:
    post:
      summary: 多模态视频编辑 (删减视频选区)
      description: "上游文档链接已按合规要求移除;接口契约以本平台线上实测为准。"
      tags:
        - 快手可灵(官方格式)
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
            default: Bearer {{YOUR_API_KEY}}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: "必填。正向提示词,上限 500 字符。"
                  maxLength: 500
                negative_prompt:
                  type: string
                  description: "可选。负向提示词,上限 200 字符。"
                  maxLength: 200
                cfg_scale:
                  type: number
                  description: "可选。与提示词的贴合程度,区间 [0,1],数值越大越贴近。"
                  minimum: 0
                  maximum: 1
                mode:
                  type: string
                  description: "可选。生成模式二选一:std(高性能)、pro(高表现)。"
                  enum:
                    - std(高性能)
                    - pro(高表现)
                camera_control:
                  type: object
                  properties:
                    type:
                      type: string
                    config:
                      type: object
                      properties:
                        horizontal:
                          type: integer
                          minimum: -10
                          maximum: 10
                          description: "可选。横向镜头平移幅度,区间 [-10, 10]。"
                        vertical:
                          type: integer
                          minimum: -10
                          maximum: 10
                          description: "可选。纵向镜头平移幅度,区间 [-10, 10]。"
                        pan:
                          type: integer
                          description: "可选。横向摇摆幅度,区间 [-10, 10]。"
                          minimum: -10
                          maximum: 10
                        tilt:
                          type: integer
                          description: "可选。纵向摇摆幅度,区间 [-10, 10]。"
                          minimum: -10
                          maximum: 10
                        roll:
                          type: integer
                          description: "可选。镜头旋转幅度,区间 [-10, 10]。"
                          minimum: -10
                          maximum: 10
                        zoom:
                          type: integer
                          description: "可选。变焦幅度,区间 [-10, 10]。"
                          minimum: -10
                          maximum: 10
                      description: "由六个字段组成,用来配置镜头运动或变化。"
                  description: "可选。镜头运动协议,留空则由系统自动匹配。"
                aspect_ratio:
                  type: string
                  description: "可选。画面比例,支持 16:9、9:16、1:1。"
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                duration:
                  type: string
                  description: "可选。成片时长(秒),取 5 或 10。"
                  enum:
                    - '5'
                    - '10'
                callback_url:
                  type: string
                  description: "可选。任务完成后向该地址推送结果。"
                model_name:
                  type: string
                  description: "可选模型:kling-v1、kling-v1-5、kling-v1-6。"
              required:
                - prompt
            example:
              session_id: string
              frame_index: int
              points: object[]
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: "错误码,含义见错误码对照表。"
                  message:
                    type: string
                    description: "错误信息。"
                  request_id:
                    type: string
                    description: "系统为每次调用分配的请求编号,便于追踪链路与定位故障。"
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: "任务 ID,由系统分配。"
                      task_status:
                        type: string
                        description: "任务所处阶段;取值 submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)。"
                        enum:
                          - submitted(已提交
                          - processing(处理中)
                          - succeed(成功)
                          - failed(失败)
                      created_at:
                        type: integer
                        description: "任务落库时刻,Unix 时间戳,单位毫秒。"
                      updated_at:
                        type: integer
                        description: "任务最近更新时刻,Unix 时间戳,单位毫秒。"
                    required:
                      - task_id
                      - updated_at
                      - created_at
                      - task_status
                required:
                  - code
                  - message
                  - request_id
                  - data
              example:
                code: 0
                message: string
                request_id: string
                data:
                  task_id: string
                  task_status: string
                  created_at: 0
                  updated_at: 0
          headers: {}
      security: []
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []