Kling-3.0 motion-control

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.

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The model name to use for generation. Required field. - Must be kling-3.0/motion-control for this endpoint Default："kling-3.0/motion-control"。 Allowed values：kling-3.0/motion-control。 Example：kling-3.0/motion-control。
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. (Optional) Text prompt words, used to guide the generation of animation content. Can be empty or 0 - 2500 characters long. maxLength: 2000.
input_urls	array<string>	Yes	(Required) Include a URL of an image maxItems: 1.
video_urls	array<string>	Yes	(Required) Include a video URL maxItems: 1.
mode	string	No	Optional. Output resolution: "720p" (default) or "1080p". Default："720p"。 Allowed values：720p / 1080p。 Example：720p。
character_orientation	string	No	(Optional) Reference source for character orientation. video: Refer to video (recommended); image: Refer to image. Default value: video

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/motion-control",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "prompt": "A paper boat drifting down a rainy street.",
  "mode": "720p"
}'

{
  "model": "kling-3.0/motion-control",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "prompt": "A paper boat drifting down a rainy street.",
  "mode": "720p"
}

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": {}
}