Kling O3 API

{
  "additionalProperties": false,
  "allOf": [
    {
      "if": {
        "properties": {
          "shot_type": {
            "const": "customize"
          }
        },
        "required": [
          "shot_type"
        ]
      },
      "then": {
        "required": [
          "multi_prompt"
        ]
      }
    }
  ],
  "properties": {
    "aspect_ratio": {
      "default": "16:9",
      "description": "Output aspect ratio.",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string"
    },
    "duration_seconds": {
      "default": 5,
      "description": "Output length in whole seconds, from 3 to 15. Billed per second.",
      "maximum": 15,
      "minimum": 3,
      "type": "integer"
    },
    "elements": {
      "description": "One named subject built from 2 to 4 images of the same character or object. Write @name in the prompt where it should appear. 4K only.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "description": "One line on who or what this subject is.",
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "end_ms": {
            "description": "Trim end, in milliseconds, when the subject is taken from a video clip. Defaults to 8000.",
            "minimum": 0,
            "type": "integer"
          },
          "image_urls": {
            "description": "2 to 4 images of this subject.",
            "items": {
              "format": "uri",
              "type": "string"
            },
            "maxItems": 4,
            "minItems": 2,
            "type": "array"
          },
          "name": {
            "description": "Name for this subject; write @name in the prompt where it should appear.",
            "maxLength": 64,
            "minLength": 1,
            "type": "string"
          },
          "reference_audio_urls": {
            "description": "Optional voice samples for this subject, 5 to 30 seconds each.",
            "items": {
              "format": "uri",
              "type": "string"
            },
            "type": "array"
          },
          "start_ms": {
            "description": "Trim start, in milliseconds, when the subject is taken from a video clip. Defaults to 0.",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "name",
          "description",
          "image_urls"
        ],
        "type": "object"
      },
      "maxItems": 1,
      "type": "array"
    },
    "generate_audio": {
      "default": false,
      "description": "Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second. Not available with a reference video.",
      "type": "boolean"
    },
    "keep_original_audio": {
      "default": true,
      "description": "Keep the reference video's own sound in the result. Only matters when a reference video is given.",
      "type": "boolean"
    },
    "multi_prompt": {
      "description": "Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "duration_seconds": {
            "description": "Length of this shot in whole seconds, 1 to 15.",
            "maximum": 15,
            "minimum": 1,
            "type": "integer"
          },
          "prompt": {
            "description": "What happens in this shot, up to 512 characters.",
            "maxLength": 512,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "prompt",
          "duration_seconds"
        ],
        "type": "object"
      },
      "maxItems": 6,
      "minItems": 1,
      "type": "array"
    },
    "prompt": {
      "description": "Say who and what each reference is (<<<image_1>>>, <<<image_2>>> and so on) and describe the shot they should produce.",
      "maxLength": 2500,
      "minLength": 1,
      "type": "string"
    },
    "reference_image_urls": {
      "description": "Reference images for characters, objects, outfits or places, up to 7. Refer to them in the prompt as <<<image_1>>>, <<<image_2>>> and so on.",
      "items": {
        "contentMediaType": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/gif"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 7,
      "minItems": 1,
      "type": "array"
    },
    "reference_video_urls": {
      "description": "Optional reference video (one clip) whose motion, camera or characters the new shot should draw on. Refer to it in the prompt as <<<video_1>>>. With a video, use up to 4 reference images. A run with a reference video is billed at a higher per-second rate.",
      "items": {
        "contentMediaType": [
          "video/mp4",
          "video/webm",
          "video/quicktime"
        ],
        "format": "uri",
        "type": "string"
      },
      "maxItems": 1,
      "minItems": 1,
      "type": "array"
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Higher tiers cost more per second.",
      "enum": [
        "720p",
        "1080p",
        "4k"
      ],
      "type": "string"
    },
    "shot_type": {
      "default": "single",
      "description": "single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.",
      "enum": [
        "single",
        "multi",
        "customize"
      ],
      "type": "string"
    }
  },
  "required": [
    "prompt",
    "reference_image_urls"
  ],
  "type": "object"
}