kling-v2-6

Text to Video
Image to Video
Motion Control
Voice Management

Create task

POST /kling/v1/videos/text2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/text2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "prompt": "A corgi runs along a beach at sunset as waves cross the sand",
    "negative_prompt": "blurry, shaky",
    "duration": "5",
    "mode": "pro",
    "sound": "on",
    "aspect_ratio": "16:9",
    "watermark_info": {"enabled": false}
  }'

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Must be application/json.

Request body

string

required

Must be kling-2.6.

string

required

Positive prompt, up to 2,500 characters.

string

Content to avoid, up to 2,500 characters.

object[]

Up to two voices. Each item contains a voice_id from Voice Management.

string

default:"off"

on or off. Must be on when voice_list is used.

string

default:"std"

std for 720p or pro for 1080p.

string

default:"5"

Fixed duration: 5 or 10 seconds.

string

default:"16:9"

16:9, 9:16, or 1:1.

object

Preset or custom camera movement.

object

Use enabled to request an additional watermarked result.

Specified voice

voice_list accepts up to two voices. Reference them as <<<voice_1>>> and <<<voice_2>>> in list order, and set sound to on.

{
  "model_name": "kling-2.6",
  "prompt": "<<<voice_1>>> says: 'Welcome to today's program'",
  "voice_list": [{"voice_id": "voice-id"}],
  "duration": "5",
  "mode": "pro",
  "sound": "on",
  "aspect_ratio": "16:9"
}

Camera control

camera_control.type supports simple, down_back, forward_up, right_turn_forward, and left_turn_forward. In simple mode, set one nonzero property in config: horizontal, vertical, pan, tilt, roll, or zoom. Each property ranges from -10 to 10.

Query task by ID

GET /kling/v1/videos/text2video/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format. Use application/json.

Path parameters

string

required

The task_id returned by the create request.

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/text2video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

Response fields

integer

0 indicates that the query was accepted.

string

Error information; empty for a successful query.

string

Queried task ID.

string

submitted, processing, succeed, or failed.

string

Failure details when the task fails.

object[]

Generated videos, returned after success.

string

Temporary generated-video URL.

string

Actual duration in seconds.

integer

Creation Unix timestamp in milliseconds.

integer

Last update Unix timestamp in milliseconds.

200

{
  "code": 0,
  "data": {
    "created_at": 1784720894000,
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_result": {"videos": [{"duration": "5", "url": "https://example.com/generated-video.mp4"}]},
    "task_status": "succeed",
    "updated_at": 1784721103000
  },
  "message": ""
}

Generated result URLs are removed after 30 days. Save the files promptly.

Create task

POST /kling/v1/videos/image2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "image": "https://example.com/first-frame.png",
    "image_tail": "https://example.com/end-frame.png",
    "prompt": "The camera slowly pulls back as the person smiles",
    "duration": "5",
    "mode": "pro",
    "sound": "off"
  }'

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-6",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Must be application/json.

Request body

string

required

Must be kling-2.6.

string

Start frame URL or raw Base64. At least one of image and image_tail is required.

string

End frame. It cannot be combined with dynamic_masks, static_mask, or camera_control.

string

Positive prompt, up to 2,500 characters.

string

Negative prompt, up to 2,500 characters.

object[]

Up to two items, each containing voice_id.

string

default:"off"

on or off. Must be on when a voice is referenced.

string

default:"std"

std for 720p or pro for 1080p.

string

default:"5"

5 or 10 seconds.

string

Static motion mask as a URL or raw Base64.

object[]

Up to six dynamic motion-brush masks.

object

Preset or custom camera movement.

object

Use enabled to request an additional watermarked result.

Image requirements

Use a public URL or raw Base64 without a data:image/...;base64, prefix.
Use JPG, JPEG, or PNG. Files must be no larger than 10 MB, each side must be at least 300 px, and the aspect ratio must be between 1:2.5 and 2.5:1.
At least one of image and image_tail is required.
End-frame control, motion brush, and camera_control cannot be used together.

Motion brush

string

required

A dynamic-area mask matching the input image dimensions.

object[]

required

Trajectory coordinates. A 5-second video accepts 2–77 points.

integer

required

X coordinate, using the image’s bottom-left corner as the origin.

integer

required

Y coordinate, using the image’s bottom-left corner as the origin.

Specified voice example

{
  "model_name": "kling-2.6",
  "image": "https://example.com/person.png",
  "prompt": "<<<voice_1>>> makes the person say: 'Welcome everyone'",
  "voice_list": [{"voice_id": "voice-id"}],
  "duration": "5",
  "mode": "pro",
  "sound": "on"
}

Query task by ID

GET /kling/v1/videos/image2video/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format. Use application/json.

Path parameters

string

required

The image-to-video task ID.

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/image2video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

Response fields

integer

0 indicates that the query was accepted.

string

Error information; empty for a successful query.

string

Queried task ID.

string

submitted, processing, succeed, or failed.

string

Failure details when the task fails.

object[]

Generated videos, returned after success.

string

Temporary generated-video URL.

string

Actual duration in seconds.

integer

Creation Unix timestamp in milliseconds.

integer

Last update Unix timestamp in milliseconds.

200

{
  "code": 0,
  "data": {
    "created_at": 1784720894000,
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_result": {"videos": [{"duration": "5", "url": "https://example.com/generated-video.mp4"}]},
    "task_status": "succeed",
    "updated_at": 1784721103000
  },
  "message": ""
}

Generated result URLs are removed after 30 days. Save the files promptly.

Create task

POST /kling/v1/videos/motion-control

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/motion-control \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.6",
    "image_url": "https://example.com/character.png",
    "video_url": "https://example.com/motion.mp4",
    "prompt": "Preserve the character and reproduce the reference motion",
    "character_orientation": "video",
    "keep_original_sound": "yes",
    "mode": "pro"
  }'

200

{"code":0,"message":"SUCCEED","request_id":"request-id","data":{"task_id":"task-id","task_status":"submitted"}}

Request body

string

required

Must be kling-2.6.

string

Additional visual or camera instructions, up to 2,500 characters.

string

required

Character image URL or raw Base64.

string

required

Public URL for the motion reference video.

object[]

Up to one legacy element. When used, character_orientation must be video.

string

required

Element ID returned by the Legacy Element Management API.

string

default:"yes"

Keep reference-video audio: yes or no.

string

required

Character orientation source: image or video.

string

default:"std"

std or pro.

object

Use enabled to request an additional watermarked result.

Media requirements

Images: JPG, JPEG, or PNG; up to 10 MB; each side 300–65,536 px; aspect ratio 1:2.5 through 2.5:1. Keep the head, upper body, or full body visible and avoid occlusion or extreme orientation.
Videos: MP4 or MOV; up to 100 MB; each side 340–3,850 px; at least 3 seconds long.
Maximum duration is 10 seconds for character_orientation: "image" and 30 seconds for character_orientation: "video".
Use one continuous shot, keep the person in frame, avoid cuts and aggressive camera movement, and prefer a single person with moderate motion speed.

For difficult or fast motion, the model may extract only the usable continuous segment and return a result shorter than the uploaded video. A task can still run when at least 3 seconds of continuous usable motion is found, and consumed credits are not refunded. Reduce the motion difficulty or speed when needed.

Query task by ID

GET /kling/v1/videos/motion-control/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format. Use application/json.

Path parameters

string

required

The motion-control task ID.

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/motion-control/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

Response fields

integer

0 indicates that the query was accepted.

string

Error information; empty for a successful query.

string

Queried task ID.

string

submitted, processing, succeed, or failed.

string

Failure details when the task fails.

object[]

Generated videos, returned after success.

string

Temporary generated-video URL.

string

Actual duration in seconds.

integer

Creation Unix timestamp in milliseconds.

integer

Last update Unix timestamp in milliseconds.

200

{
  "code": 0,
  "data": {
    "created_at": 1784720894000,
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_result": {"videos": [{"duration": "5", "url": "https://example.com/generated-video.mp4"}]},
    "task_status": "succeed",
    "updated_at": 1784721103000
  },
  "message": ""
}

Generated result URLs are removed after 30 days. Save the files promptly.

Endpoints

Operation	Method and path
Create custom voice	`POST /kling/v1/general/custom-voices`
Query custom voice	`GET /kling/v1/general/custom-voices/{id}`
List preset voices	`GET /kling/v1/general/presets-voices`

Create custom voice

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/general/custom-voices \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "voice_name": "Narrator",
    "voice_url": "https://example.com/voice.mp3"
  }'

200

{"id":"asyntask_xxx","task_id":"asyntask_xxx","object":"video","model":"kling-voices","status":"queued","progress":0,"created_at":1784778266}

string

required

Custom voice name, up to 20 characters.

string

Public MP3, WAV, MP4, or MOV URL. At least one of voice_url and video_id is required.

string

An eligible previously generated video ID. At least one of voice_url and video_id is required.

The source must contain one clear speaker and be 5–30 seconds long. Creation status can be submitted, processing, succeed, or failed. A successful result provides voice_id and trial_url.

Query custom voice

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/general/custom-voices/VOICE_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

A successful voice item contains voice_id, voice_name, trial_url, and owned_by.

List preset voices

cURL

curl --request GET \
  --url 'https://www.anyfast.ai/kling/v1/general/presets-voices?pageNum=1&pageSize=30' \
  --header 'Authorization: Bearer YOUR_API_KEY'

integer

default:1

Page number from 1 to 1,000.

integer

default:30

Page size from 1 to 1,000.

Each item in data[] contains task metadata and task_result.voices[]. A voice contains voice_id, voice_name, trial_url, owned_by, and status. Current official preset voices return owned_by: "vod".

This page uses the Kling Legacy request structure. AnyFast adds the /kling routing prefix to Legacy paths. It does not include new model-specific endpoints or the unavailable video task-list queries.

Overview

Native Compatible Endpoints

Model APIs

Create task

Request headers

Request body

Specified voice

Camera control

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request headers

Request body

Image requirements

Motion brush

Specified voice example

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request body

Media requirements

Query task by ID

Request headers

Path parameters

Response fields

Endpoints

Create custom voice

Query custom voice

List preset voices

​Create task

​Request headers

​Request body

​Specified voice

​Camera control

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Create task

​Request headers

​Request body

​Image requirements

​Motion brush

​Specified voice example

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Create task

​Request body

​Media requirements

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Endpoints

​Create custom voice

​Query custom voice

​List preset voices

Create task

Request headers

Request body

Specified voice

Camera control

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request headers

Request body

Image requirements

Motion brush

Specified voice example

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request body

Media requirements

Query task by ID

Request headers

Path parameters

Response fields

Endpoints

Create custom voice

Query custom voice

List preset voices