POST
/
kling-v2-5-turbo
/
generate
Generate Video
curl --request POST \
  --url https://api.unifically.com/kling-v2-5-turbo/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.5 Turbo model, optimized for speed and performance.

Mode Support

The mode is automatically determined by the resolution:
  • 720pstd mode (start image only)
  • 1080ppro mode (start + end image support)

Pricing

For current pricing, see the Pricing page.

Request (720p - Standard Mode)

curl --location 'https://api.unifically.com/kling-v2-5-turbo/generate' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "dog running through a meadow",
  "start_image_url": "https://example.com/dog.jpg",
  "duration": 10,
  "resolution": "720p"
}'

Request (1080p - Pro Mode with End Image)

curl --location 'https://api.unifically.com/kling-v2-5-turbo/generate' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "person transforming",
  "start_image_url": "https://example.com/start.jpg",
  "end_image_url": "https://example.com/end.jpg",
  "duration": 5,
  "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"
  }
}