Kling 3.0 Omni Transformation

Input mode 1: Video Input Only

Endpoint

POST /videos/generations

Full URL: https://modelfold.ai/v1/videos/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.

Input parameters for the generation task.

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The name of the model used to generate the task. This field is required. - This endpoint requires the kling-3.0-omni/transformation model Default："kling-3.0-omni/transformation"。 Allowed values：kling-3.0-omni/transformation。 Example：kling-3.0-omni/transformation。
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. Video description. It must not be empty after leading and trailing whitespace is removed. Maximum length: 3,072 characters. minLength: 1. maxLength: 2000. Example：Transform the input video into a cinematic night scene while preserving the character movements from the original video.。
video_urls	array<string>	Yes	Array of video URLs. Exactly 1 video is required. HTTP, HTTPS, and OSS URLs are supported. Videos must be in MP4 or MOV format; each file must not exceed 200 MB; duration must be between 3 and 15.5 seconds; width and height must each be between 700 and 4,553 px; total pixels must not exceed 8,294,400; the aspect ratio must be between 0.4 and 2; and the frame rate must be between 24 and 60 fps. minItems: 1. maxItems: 1.
resolution	string	No	Video resolution. 720p outputs a 720p video, 1080p outputs a 1080p video, and 4k outputs a 4K video. Default："720p"。 Allowed values：720p / 1080p / 4k。 Example：720p。
aspect_ratio	string	No	Video aspect ratio. Only auto can be used with video-only input. Default："auto"。 Allowed values：auto。 Example：auto。
audio	boolean	No	No audio is generated when a video is provided; set false. Allowed values：false / true。 Example：false。
elements	array<object>	No	List of one-time subject assets. The default is an empty array. When using only multi-image subjects, up to 7 subjects can be uploaded. When using only video character subjects, the number of video character subjects must not exceed 3. When using both video character and multi-image subjects, the number of video character subjects must not exceed 3, and the number of multi-image subjects must not exceed 4. Default：[]。
elements[].name	string	Yes	Subject name. It must be unique within the same request and can be referenced in the prompt field using @name. minLength: 1. Example：element_dog。
elements[].description	string	Yes	Text description of the subject asset. minLength: 1. Example：A happy golden retriever。
elements[].element_input_urls	array<string>	Yes	List of image URLs for a multi-image subject (provide 2 to 4 images), or a video URL for a video character subject (provide exactly 1 video). Images and videos cannot be mixed. HTTP, HTTPS, and OSS URLs are supported. minItems: 1. maxItems: 4.
elements[].element_input_audio_urls	array<string>	No	Optional list of subject audio asset URLs. HTTP, HTTPS, and OSS URLs are supported. Default：[]。

Request Example

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0-omni/transformation",
  "prompt": "Transform the input video into a cinematic night scene while preserving the character movements from the original video.",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "resolution": "720p",
  "aspect_ratio": "auto",
  "elements": [
    {
      "name": "element_dog",
      "description": "A happy golden retriever",
      "element_input_urls": [
        "https://example.com/reference.png"
      ]
    }
  ]
}'

{
  "model": "kling-3.0-omni/transformation",
  "prompt": "Transform the input video into a cinematic night scene while preserving the character movements from the original video.",
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "resolution": "720p",
  "aspect_ratio": "auto",
  "elements": [
    {
      "name": "element_dog",
      "description": "A happy golden retriever",
      "element_input_urls": [
        "https://example.com/reference.png"
      ]
    }
  ]
}

Response

200 — Generation completed. usage contains actual billing details; result URLs are illustrative.

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}

Input mode 2: Video with Images

Endpoint

POST /videos/generations

Full URL: https://modelfold.ai/v1/videos/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.

Input parameters for the generation task.

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The name of the model used to generate the task. This field is required. - This endpoint requires the kling-3.0-omni/transformation model Default："kling-3.0-omni/transformation"。 Allowed values：kling-3.0-omni/transformation。 Example：kling-3.0-omni/transformation。
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. Video description. It must not be empty after leading and trailing whitespace is removed. Maximum length: 3,072 characters. minLength: 1. maxLength: 2000. Example：Transform the video into a cinematic night scene using the style of the input images as a reference.。
image_urls	array<string>	Yes	Array of image URLs, with up to 4 images. HTTP, HTTPS, and OSS URLs are supported. Images must be in JPG, JPEG, or PNG format; each file must not exceed 50 MB; both width and height must be at least 300 px; and the aspect ratio must be between 0.4 and 2.5. maxItems: 4.
video_urls	array<string>	Yes	Array of video URLs. Exactly 1 video is required. HTTP, HTTPS, and OSS URLs are supported. Videos must be in MP4 or MOV format; each file must not exceed 200 MB; duration must be between 3 and 15.5 seconds; width and height must each be between 700 and 4,553 px; total pixels must not exceed 8,294,400; the aspect ratio must be between 0.4 and 2; and the frame rate must be between 24 and 60 fps. minItems: 1. maxItems: 1.
duration	string	No	Video duration. This field may be configured when using a video with images. Example：5。
resolution	string	No	Video resolution. 720p outputs a 720p video, 1080p outputs a 1080p video, and 4k outputs a 4K video. Default："720p"。 Allowed values：720p / 1080p / 4k。 Example：720p。
aspect_ratio	string	No	Video aspect ratio. When using a video with images, 16:9, 9:16, and 1:1 are supported; auto is not supported. Default："16:9"。 Allowed values：16:9 / 9:16 / 1:1。 Example：16:9。
audio	boolean	No	No audio is generated when a video is provided; set false. Allowed values：false / true。 Example：false。
elements	array<object>	No	List of one-time subject assets. The default is an empty array. When using only multi-image subjects, up to 7 subjects can be uploaded. When using only video character subjects, the number of video character subjects must not exceed 3. When using both video character and multi-image subjects, the number of video character subjects must not exceed 3, and the number of multi-image subjects must not exceed 4. Default：[]。
elements[].name	string	Yes	Subject name. It must be unique within the same request and can be referenced in the prompt field using @name. minLength: 1. Example：element_dog。
elements[].description	string	Yes	Text description of the subject asset. minLength: 1. Example：A happy golden retriever。
elements[].element_input_urls	array<string>	Yes	List of image URLs for a multi-image subject (provide 2 to 4 images), or a video URL for a video character subject (provide exactly 1 video). Images and videos cannot be mixed. HTTP, HTTPS, and OSS URLs are supported. minItems: 1. maxItems: 4.
elements[].element_input_audio_urls	array<string>	No	Optional list of subject audio asset URLs. HTTP, HTTPS, and OSS URLs are supported. Default：[]。

Request Example

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0-omni/transformation",
  "prompt": "Transform the video into a cinematic night scene using the style of the input images as a reference.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "elements": [
    {
      "name": "element_dog",
      "description": "A happy golden retriever",
      "element_input_urls": [
        "https://example.com/reference.png"
      ]
    }
  ]
}'

{
  "model": "kling-3.0-omni/transformation",
  "prompt": "Transform the video into a cinematic night scene using the style of the input images as a reference.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "elements": [
    {
      "name": "element_dog",
      "description": "A happy golden retriever",
      "element_input_urls": [
        "https://example.com/reference.png"
      ]
    }
  ]
}

Response

200 — Generation completed. usage contains actual billing details; result URLs are illustrative.

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}