Kling 3.0 is an advanced video generation model that supports:
  • Text-to-video generation
  • Image-to-video generation (start frame, or start + end frames)
  • Multi-shot video generation with auto or custom scene timing
  • Audio generation
  • Resolutions: 720p (std) and 1080p (pro)
  • Aspect ratios: 1:1, 16:9, 9:16
  • Duration: 3-15 seconds

​
Model

kuaishou/kling-3.0

​
Parameters

ParameterTypeRequiredDefaultDescription
promptstring✅ Yes-Main text description for the video generation
start_image_urlstringNonullURL of the starting frame image
end_image_urlstringNonullURL of the ending frame image (ignored in multi-shot mode)
durationintegerNo3Video duration in seconds (3-15). In custom multi-shot mode, this is calculated from shot durations
modestringNo"std"Mode: "std" (720p) or "pro" (1080p)
aspect_ratiostringNo"1:1"Video aspect ratio: "1:1", "16:9", or "9:16"
soundbooleanNofalseEnable audio generation for the video
enhance_promptbooleanNofalseEnable AI prompt enhancement
multi_shotarrayNonullArray of shots for multi-shot generation (see Multi-Shot Modes below)
multi_shot_modestringNo"auto"Multi-shot timing mode: "auto" or "custom"

​
Multi-Shot Modes

​
1. Multi-Shot Disabled (Standard Generation)

Generate a single continuous video with one prompt. Example Request: 
{
  "prompt": "A person walking through a park",
  "duration": 10,
  "aspect_ratio": "16:9",
  "mode": "std",
  "sound": true,
  "enhance_prompt": true
}

​
2. Auto Multi-Shot Mode

Let the API automatically divide the duration among multiple shots. The system automatically calculates the duration for each shot to fit within the total duration. Example Request: 
{
  "prompt": "A cinematic sequence of a city at sunset",
  "duration": 6,
  "aspect_ratio": "16:9",
  "mode": "std",
  "sound": true,
  "multi_shot_mode": "auto",
  "multi_shot": [
    {"prompt": "Wide shot of city skyline"},
    {"prompt": "Close-up of buildings"}
  ]
}
Key Points:
  • Set multi_shot_mode to "auto"
  • Provide multi_shot array with prompts
  • API automatically divides the total duration evenly among the shots
  • Each shot gets equal timing (e.g., 6 seconds total ÷ 2 shots = 3 seconds each)

​
3. Custom Multi-Shot Mode

Manually specify the exact prompt and duration for each shot. Full control over scene timing. Example Request: 
{
  "aspect_ratio": "16:9",
  "mode": "std",
  "sound": true,
  "multi_shot_mode": "custom",
  "multi_shot": [
    {
      "prompt": "Person walking towards camera",
      "duration": 5
    },
    {
      "prompt": "Close-up of person smiling",
      "duration": 4
    },
    {
      "prompt": "Wide shot of the landscape",
      "duration": 6
    }
  ]
}
Key Points:
  • Set multi_shot_mode to "custom"
  • Each entry in multi_shot array must include both prompt and duration
  • Total duration across all shots must not exceed 15 seconds
  • The main prompt field becomes optional (you can omit it entirely)

​
Multi-Shot Validation Rules

​
Custom Mode (multi_shot_mode: "custom")

  • ✅ Each shot must have a prompt field
  • ✅ Each shot must have a duration field (minimum 1 second)
  • ✅ Total duration of all shots must not exceed 15 seconds
  • ✅ Each shot duration must be at least 1 second

​
Auto Mode (multi_shot_mode: "auto")

  • ✅ Shots can have just prompts (durations auto-calculated)
  • ✅ API will evenly distribute the total duration among shots

​
Resolution & Mode Mapping

ResolutionModeWidthHeight (1:1)Width (16:9)Height (16:9)Width (9:16)Height (9:16)
720pstd72072012807207201280
1080ppro108010801920108010801920

​
Image Upload Support

When providing start_image_url or end_image_url:
  • Images are automatically uploaded and processed
  • Start frame helps maintain character/scene consistency
  • End frame guides the final pose/position (ignored in multi-shot mode)
  • In multi-shot mode, only start_image_url is used

​
Examples

​
Example 1: Text-to-Video (Standard Mode)

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0",
    "input": {
      "prompt": "A majestic eagle soaring through mountain peaks at sunset",
      "duration": 10,
      "mode": "pro",
      "aspect_ratio": "16:9",
      "sound": true,
      "enhance_prompt": true
    }
  }'

​
Example 2: Image-to-Video with Start and End Frames

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0",
    "input": {
      "prompt": "Character walks towards the camera with a confident stride",
      "start_image_url": "https://example.com/start-pose.jpg",
      "end_image_url": "https://example.com/end-pose.jpg",
      "duration": 8,
      "mode": "pro",
      "aspect_ratio": "16:9",
      "sound": true
    }
  }'

​
Example 3: Auto Multi-Shot Mode

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0",
    "input": {
      "prompt": "A cinematic sequence of a city at sunset",
      "duration": 6,
      "aspect_ratio": "16:9",
      "mode": "std",
      "sound": true,
      "multi_shot_mode": "auto",
      "multi_shot": [
        {"prompt": "Wide shot of city skyline with golden hour lighting"},
        {"prompt": "Close-up of glass buildings reflecting the sunset"}
      ]
    }
  }'

​
Example 4: Custom Multi-Shot Mode

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "kuaishou/kling-3.0",
    "input": {
      "aspect_ratio": "16:9",
      "mode": "pro",
      "sound": true,
      "multi_shot_mode": "custom",
      "multi_shot": [
        {
          "prompt": "Person walking towards camera in a park",
          "duration": 5
        },
        {
          "prompt": "Close-up of person smiling warmly",
          "duration": 4
        },
        {
          "prompt": "Wide shot of the beautiful landscape panorama",
          "duration": 6
        }
      ]
    }
  }'

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}

​
Pricing

ResolutionPrice
1080p$0.04/s
720p$0.03/s
Sound add-on:
QualityExtra Cost
Standard (720p)+$0.075
Pro (1080p)+$0.12