POST
https://api.unifically.com
/
kling-v2.1
/
generate
Generate Video
curl --request POST \
  --url https://api.unifically.com/kling-v2.1/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "start_image_url": "<string>",
  "end_image_url": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "motion_id": "<string>",
  "enhance_prompt": true,
  "seed": 123,
  "callback_url": "<string>"
}
'
{
  "code": 200,
  "data": {
    "status": "processing",
    "task_id": "dd55ae25-adff-47a0-9194-6a37845b58e4",
    "error": {}
  }
}
Generate high-quality AI videos using the Kling v2.1 model with flexible generation modes.

​
Mode Support

The mode is automatically determined by the resolution:
  • 720p → std mode (start image only)
  • 1080p → pro mode (start + end image support)

​
Pricing

Mode5s10s
Standard$0.13$0.27
Pro$0.27$0.53

​
Request (720p - Standard Mode)

curl --location 'https://api.unifically.com/kling-v2.1/generate' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "A butterfly landing on a flower in slow motion",
  "start_image_url": "https://example.com/butterfly.jpg",
  "duration": 5,
  "resolution": "720p"
}'

​
Request (1080p - Pro Mode with End Image)

curl --location 'https://api.unifically.com/kling-v2.1/generate' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "Smooth transition from start to end scene",
  "start_image_url": "https://example.com/start.jpg",
  "end_image_url": "https://example.com/end.jpg",
  "duration": 10,
  "resolution": "1080p"
}'

​
Parameters

​
Required Parameters

​
prompt
string
required
Text description of the video to generate
​
start_image_url
string
required
URL of the starting image for video generation

​
Optional Parameters

​
end_image_url
string
URL of the ending image (only supported with 1080p resolution)
​
duration
integer
Video duration in secondsOptions: 5 or 10Default: 5
​
resolution
string
Video resolution - determines the mode automatically
  • 720p → std mode (start image only)
  • 1080p → pro mode (start + end image support)
Options: 720p or 1080pDefault: 1080p
​
motion_id
string
Motion preset UUID for controlling video motion styleDefault: default motion preset
​
enhance_prompt
boolean
Enhance the prompt with AI for better resultsDefault: true
​
seed
integer
Seed for reproducibility. Use the same seed to generate similar results.Default: random
​
callback_url
string
URL to receive webhook notification on completion

​
Validation Rules

  • End Image: Only allowed with 1080p resolution
  • Duration: Must be exactly 5 or 10 seconds
  • Resolution: Supports both 720p and 1080p
  • Motion ID: Must be a valid UUID format if provided

​
Response

{
  "code": 200,
  "data": {
    "status": "processing",
    "task_id": "dd55ae25-adff-47a0-9194-6a37845b58e4",
    "error": {}
  }
}

​
Response Fields

​
code
integer
default:"200"
HTTP status code (200 for success)
​
data
object
Response data
​
task_id
string
Unique identifier for this generation task
​
error
object
Error information (empty object for successful requests)

​
Error Response

{
  "code": 400,
  "error": {
    "message": "Error description",
    "code": "ERROR_CODE"
  }
}