Kling 4.0 API

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "auto",
      "description": "Output aspect ratio; auto follows the source clip.",
      "enum": [
        "auto",
        "16:9",
        "9:16",
        "1:1",
        "21:9"
      ],
      "type": "string",
      "x-ui": {
        "order": 80,
        "widget": "select"
      }
    },
    "duration_seconds": {
      "default": -1,
      "description": "Output length in whole seconds, from 3 to 30, or -1 to match the source clip. Billed per second.",
      "enum": [
        -1,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30
      ],
      "type": "integer",
      "x-ui": {
        "affects_price": true,
        "enum_labels": {
          "-1": "Match source"
        },
        "order": 60,
        "unit": "s",
        "widget": "slider"
      }
    },
    "keep_original_audio": {
      "default": true,
      "description": "Keep the source clip's own sound. Turn it off to generate new synchronized audio instead.",
      "type": "boolean",
      "x-ui": {
        "order": 63,
        "widget": "switch"
      }
    },
    "prompt": {
      "description": "Describe the edit: change a subject, the setting, the weather or the style. Refer to the video as @Video1 and to reference images as @Image1, @Image2, numbered in upload order.",
      "minLength": 1,
      "type": "string",
      "x-ui": {
        "order": 100,
        "primary": true,
        "reference_tokens": {
          "reference_image_urls": "@Image{index}"
        },
        "widget": "textarea"
      }
    },
    "reference_image_urls": {
      "description": "Optional reference images for a subject, object or style to bring into the edit, up to 10. Refer to them as @Image1, @Image2 and so on.",
      "items": {
        "contentMediaType": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array",
      "x-ui": {
        "max_size_mb": 10,
        "order": 85,
        "widget": "multi-upload"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. 1080p costs more per second.",
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": true,
        "order": 70,
        "widget": "radio"
      }
    },
    "video_url": {
      "contentMediaType": [
        "video/mp4",
        "video/webm",
        "video/quicktime"
      ],
      "description": "The clip to edit (MP4 or WebM), 3 to 30 seconds. The edit keeps its scene, subject and motion. Its seconds are billed together with the output seconds.",
      "format": "uri",
      "minLength": 1,
      "type": "string",
      "x-ui": {
        "accept": [
          "video/mp4",
          "video/webm"
        ],
        "affects_price": true,
        "max_duration_seconds": 30,
        "order": 90,
        "widget": "upload"
      }
    }
  },
  "required": [
    "prompt",
    "video_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "duration_capped",
    "variantFields": [
      "resolution"
    ]
  }
}