Kling Video Generation

Generate AI videos through AceDataCloud's Kuaishou Kling API.

Authentication

export ACEDATACLOUD_API_TOKEN="your-token-here"

Quick Start

curl -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v2-5-turbo", "mode": "std", "duration": 5}'

Models

Quality Modes

Workflows

1. Text-to-Video

POST /kling/videos
{
  "action": "text2video",
  "prompt": "a futuristic city with flying cars",
  "model": "kling-v2-5-turbo",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

2. Image-to-Video

Animate a still image. Optionally specify an ending frame.

POST /kling/videos
{
  "action": "image2video",
  "prompt": "the scene slowly comes alive with movement",
  "start_image_url": "https://example.com/scene.jpg",
  "end_image_url": "https://example.com/end-scene.jpg",
  "model": "kling-v2-5-turbo",
  "mode": "pro"
}

3. Extend Video

Continue an existing video with additional seconds.

POST /kling/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera pulls back to reveal the full landscape",
  "model": "kling-v2-5-turbo"
}

4. Motion Control

Apply precise camera/motion control from an image + reference video.

POST /kling/motion
{
  "image_url": "https://example.com/subject.jpg",
  "video_url": "https://example.com/motion-reference.mp4"
}

Parameters

Task Polling

POST /kling/tasks
{"task_id": "your-task-id"}

States: processing → succeed or failed.

Gotchas

• duration only supports 5 or 10 seconds
• end_image_url is only for image2video action — it defines the last frame
• Motion control (/kling/motion) is a separate endpoint from video generation
• pro mode costs roughly 2x std mode but generates faster with better quality
• Task states use "succeed" (not "succeeded") — check for this value when polling
• negative_prompt helps avoid unwanted elements (e.g., "blurry, low quality, text")