GET
/
kling
/
motions
Get Motion Presets
curl --request GET \
  --url https://api.unifically.com/kling/motions \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": [
    {
      "id": "motion-uuid-here",
      "name": "Motion Preset Name",
      "category": "camera_control"
    }
  ]
}
Fetch available motion presets to use with Kling video generation. Use the returned motion_id in your video generation requests. Results are cached for 30 minutes.

​
Request

curl -X GET "https://api.unifically.com/kling/motions" \
--header 'Authorization: Bearer YOUR_API_KEY'

​
Query Parameters

​
size
integer
Number of results to returnDefault: 30
​
category
string
Filter motion presets by categoryAvailable Categories:
  • new - New motion presets
  • star_end_frame - Star end frame effects
  • camera_control - Camera movement controls
  • viral - Viral/trending effects
  • vfx - Visual effects
  • ugc - User-generated content effects
​
search
string
Search for effects by name

​
Available Categories

CategoryDescription
newNew motion presets
star_end_frameStar end frame effects
camera_controlCamera movement controls
viralViral/trending effects
vfxVisual effects
ugcUser-generated content effects

​
Usage

Use the motion_id from the response in your Kling video generation requests: 
curl --location 'https://api.unifically.com/kling-v2-5-turbo/generate' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "prompt": "cinematic camera movement",
  "start_image_url": "https://example.com/image.jpg",
  "motion_id": "uuid-from-motions-response",
  "resolution": "1080p"
}'

​
Response

{
  "code": 200,
  "data": [
    {
      "id": "motion-uuid-here",
      "name": "Motion Preset Name",
      "category": "camera_control"
    }
  ]
}

​
Response Fields

​
code
integer
default:"200"
HTTP status code (200 for success)
​
data
array
Array of motion presets
​
id
string
Unique identifier (UUID) for the motion preset - use this as motion_id in generation requests
​
name
string
Display name of the motion preset
​
category
string
Category of the motion preset

​
Error Response

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