## Create Task
`POST /kling/v1/videos/text2video`
Generate video from text with `model_name: "kling-3.0"`. Multi-shot storyboards, camera movement, sound, and voice references are supported.
```bash cURL theme={null}
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-3.0",
"prompt": "A rabbit wearing glasses reads a newspaper at a table",
"duration": "5",
"mode": "pro",
"sound": "on",
"aspect_ratio": "1:1"
}'
```
### Create response
```json 200 theme={null}
{
"id": "860260753860210752",
"task_id": "860260753860210752",
"object": "video",
"model": "kling-v3",
"status": "queued",
"progress": 0,
"created_at": 1773130665
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
## Request parameters
Use `kling-3.0`.
Positive prompt, up to 2,500 characters; required for a single shot or intelligent storyboard.
Negative prompt, up to 2,500 characters.
Enable multi-shot generation.
With multi-shot, use `customize` or `intelligence`.
One to six custom shots whose durations add up to `duration`.
Up to two voice references.
Use `on` or `off`; voice references require `on`.
`std` for 720p, `pro` for 1080p, or `4k`.
Video duration from 3 to 15 seconds.
Use `16:9`, `9:16`, or `1:1`.
Prompt adherence from 0 to 1.
Preset or custom camera movement.
Platform watermark configuration through `enabled`.
### Storyboards, voices, and camera movement
When `multi_shot` is true, set `shot_type` to `customize` and supply `multi_prompt`, or use `intelligence` with `prompt`. Each custom shot contains `index`, `prompt`, and `duration`; each shot lasts at least 1 second and its prompt is at most 512 characters.
Voice references use `<<>>` and `<<>>` in list order. Supply at most two `voice_id` values from voice management and set `sound` to `on`.
`camera_control.type` supports `simple`, `down_back`, `forward_up`, `right_turn_forward`, and `left_turn_forward`. For `simple`, only one of `horizontal`, `vertical`, `pan`, `tilt`, `roll`, and `zoom` may be nonzero; every value ranges from -10 to 10.
Fill in and test the full Legacy request body.
## Query task by ID
`GET /kling/v1/videos/text2video/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
### Path parameters
Text-to-video task ID returned by the create endpoint.
```bash cURL theme={null}
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'
```
```json 200 theme={null}
{
"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": ""
}
```
### Response fields
`0` indicates that the query was accepted.
Error information; empty for a successful query.
Queried task ID.
`submitted`, `processing`, `succeed`, or `failed`.
Failure details when the task fails.
Generated videos, returned after success.
Temporary generated-video URL.
Actual duration in seconds.
Creation Unix timestamp in milliseconds.
Last update Unix timestamp in milliseconds.
## Create Task
`POST /kling/v1/videos/image2video`
Generate video from a first frame, an end frame, or both with `model_name: "kling-3.0"`.
```bash cURL theme={null}
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-3.0",
"image": "https://example.com/first-frame.png",
"prompt": "The character turns and walks toward the window",
"duration": "5",
"mode": "pro",
"sound": "off"
}'
```
```json 200 theme={null}
{"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v3","status":"queued","progress":0,"created_at":1773130665}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
## Request parameters
Use `kling-3.0`.
First frame as URL or raw Base64; at least one frame is required.
End frame; mutually exclusive with motion brush and camera control.
Positive prompt, up to 2,500 characters.
Negative prompt, up to 2,500 characters.
Enable multi-shot generation.
Use `customize` or `intelligence`.
One to six custom shots.
Up to three elements; mutually exclusive with `voice_list`.
Up to two voices; requires `sound: "on"`.
Static motion-brush mask.
Up to six dynamic masks.
Preset or simple camera movement.
Use `std`, `pro`, or `4k`.
Video duration from 3 to 15 seconds.
Prompt adherence from 0 to 1.
Platform watermark setting.
Shot index, starting from 1.
Shot prompt, up to 512 characters.
Shot duration, at least 1 second; the sum must equal top-level `duration`.
Element ID returned by element management.
Voice ID returned by voice management.
Dynamic mask URL or raw Base64.
Motion trajectory coordinates.
Horizontal coordinate from the bottom-left origin.
Vertical coordinate from the bottom-left origin.
`simple` or one of four preset compound movements.
Simple movement configuration; only one of six values may be nonzero.
Add the platform watermark.
## Create response
AnyFast task ID.
Task ID, equal to `id`.
Always `video`.
Model used by the task.
Initial task status.
Initial progress.
Creation Unix timestamp.
### Image, storyboard, and motion-brush rules
`image` and `image_tail` accept a public URL or raw Base64 without a data URI prefix. Use JPG, JPEG, or PNG up to 10 MB, at least 300 px per side, with an aspect ratio from 1:2.5 to 2.5:1. At least one frame is required. An end frame, motion brush, and camera control are mutually exclusive.
Dynamic motion brush supports up to 6 masks. Mask dimensions must match the input image and each other. For a 5-second video, each trajectory contains 2–77 coordinates measured from the bottom-left corner.
Multi-shot, voice, and camera-control rules are the same as text-to-video. `element_list` and `voice_list` cannot be used together.
Fill in and test every first/end-frame, storyboard, brush, element, voice, and camera field.
## Query task by ID
`GET /kling/v1/videos/image2video/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
### Path parameters
Image-to-video task ID returned by the create endpoint.
```bash cURL theme={null}
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'
```
```json 200 theme={null}
{
"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": ""
}
```
### Response fields
`0` indicates that the query was accepted.
Error information; empty for a successful query.
Queried task ID.
`submitted`, `processing`, `succeed`, or `failed`.
Failure details when the task fails.
Generated videos, returned after success.
Temporary generated-video URL.
Actual duration in seconds.
Creation Unix timestamp in milliseconds.
Last update Unix timestamp in milliseconds.
## Create Task
`POST /kling/v1/videos/omni-video`
Use `model_name: "kling-3.0-omni"` with text, images, video, and elements for generation or editing.
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/kling/v1/videos/omni-video \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-3.0-omni",
"prompt": "The character in <<>> walks into a rainy neon street",
"image_list": [{"image_url": "https://example.com/character.png"}],
"duration": "5",
"mode": "pro",
"aspect_ratio": "16:9"
}'
```
```json 200 theme={null}
{"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v3-omni","status":"queued","progress":0,"created_at":1773130665}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
## Request parameters
Use `kling-3.0-omni`.
Up to 2,500 characters; reference media with the official placeholders.
Reference images and optional first/end frames.
At most one reference video, including `refer_type` and `keep_original_sound`.
Element count depends on whether a video is supplied.
Enable multi-shot generation.
Use `customize` or `intelligence`.
One to six custom shots.
Use `std`, `pro`, or `4k`.
Use `16:9`, `9:16`, or `1:1` when applicable.
3–15 seconds; ignored for `refer_type: "base"`.
Must be `off` when `video_list` is present.
Platform watermark setting.
Reference image URL or raw Base64.
`first_frame` or `end_frame`; an end frame requires a first frame.
Reference video URL.
`base` edits the source video; `feature` references its characteristics.
Use `yes` or `no`.
Element ID from element management.
Shot index.
Shot prompt, up to 512 characters.
Shot duration, at least 1 second.
Add the platform watermark.
## Create response
AnyFast task ID.
Task ID, equal to `id`.
Always `video`.
`kling-v3-omni`.
Initial task status.
Initial progress.
Creation Unix timestamp.
### Media constraints
Images accept URL or raw Base64, JPG/JPEG/PNG, up to 10 MB, at least 300 px per side, and aspect ratio 1:2.5 to 2.5:1. An end frame requires a first frame. Without a reference video, images plus multi-image elements total at most 7 and video-character elements at most 3. With a reference video, those limits become 4 and 1.
Reference video accepts MP4/MOV, 3–15.5 seconds, up to 200 MB, 24–60 fps, dimensions 700–4553 px, no more than 8,294,400 pixels, and aspect ratio 1:2.5 to 2.5:1.
`refer_type: "base"` edits the original video, preserves its duration, and disables multi-shot and first/end-frame controls. `refer_type: "feature"` references content, motion, style, or camera movement and can use intelligent multi-shot. `keep_original_sound` controls source audio; new sound generation is unavailable whenever a reference video is present.
Fill in and test the complete Omni Legacy request body.
## Query task by ID
`GET /kling/v1/videos/omni-video/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
### Path parameters
Omni-video task ID returned by the create endpoint.
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/kling/v1/videos/omni-video/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
```
```json 200 theme={null}
{
"code": 0,
"data": {
"created_at": 1784516360000,
"task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"task_result": {
"videos": [{
"duration": "5",
"url": "https://example.com/generated-video.mp4"
}]
},
"task_status": "succeed",
"updated_at": 1784516573000
},
"message": ""
}
```
### Response fields
`0` indicates that the query was accepted.
Error information; empty for a successful query.
Queried task ID.
`submitted`, `processing`, `succeed`, or `failed`.
Failure details when the task fails.
Generated videos, returned after success.
Temporary generated-video URL.
Actual duration in seconds.
Creation Unix timestamp in milliseconds.
Last update Unix timestamp in milliseconds.
## Create Task
`POST /kling/v1/videos/motion-control`
Transfer movement from a reference video to a character image with `model_name: "kling-3.0"`.
```bash cURL theme={null}
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-3.0",
"image_url": "https://example.com/character.png",
"video_url": "https://example.com/motion.mp4",
"prompt": "The character performs the reference action in a studio",
"keep_original_sound": "yes",
"character_orientation": "image",
"mode": "pro"
}'
```
```json 200 theme={null}
{"id":"860260753860210752","task_id":"860260753860210752","object":"video","model":"kling-v3","status":"queued","progress":0,"created_at":1773130665}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
## Request parameters
Use `kling-3.0`.
Character image as URL or raw Base64.
Motion reference video URL.
Scene, motion, or camera guidance, up to 2,500 characters.
At most one element.
Use `yes` or `no`.
Use `image` or `video`.
Use `std` or `pro`.
Platform watermark setting.
Element ID from element management; at most one.
Add the platform watermark.
## Create response
AnyFast task ID.
Task ID, equal to `id`.
Always `video`.
`kling-v3`.
Initial task status.
Initial progress.
Creation Unix timestamp.
The character image must be JPG/JPEG/PNG up to 10 MB, dimensions 300–65,536 px, and aspect ratio 1:2.5 to 2.5:1. The MP4/MOV motion video can be up to 100 MB with dimensions 340–3850 px. With `character_orientation: "image"`, the video may be 3–10 seconds; with `video`, it may be 3–30 seconds. Element references follow the video's orientation.
Complex or fast motion can produce a result shorter than the uploaded video because the model only extracts valid continuous action segments. Generation can proceed once at least 3 seconds of usable continuous motion is found. Credits consumed in this case are non-refundable, so reduce the motion complexity or speed when necessary.
Fill in and test the complete motion-control request body.
## Query task by ID
`GET /kling/v1/videos/motion-control/{task_id}`
### Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
### Path parameters
Motion-control task ID returned by the create endpoint.
```bash cURL theme={null}
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'
```
```json 200 theme={null}
{
"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": ""
}
```
### Response fields
`0` indicates that the query was accepted.
Error information; empty for a successful query.
Queried task ID.
`submitted`, `processing`, `succeed`, or `failed`.
Failure details when the task fails.
Generated videos, returned after success.
Temporary generated-video URL.
Actual duration in seconds.
Creation Unix timestamp in milliseconds.
Last update Unix timestamp in milliseconds.
## Element APIs
| Operation | Method and path |
| --------------------- | ---------------------------------------------------------- |
| Create custom element | `POST /kling/v1/general/advanced-custom-elements` |
| Query custom element | `GET /kling/v1/general/advanced-custom-elements/{task_id}` |
| List preset elements | `GET /kling/v1/general/advanced-presets-elements` |
## Create a custom element
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/kling/v1/general/advanced-custom-elements \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"element_name": "my-character",
"element_description": "The lead character",
"reference_type": "image_refer",
"element_image_list": {
"frontal_image": "https://example.com/front.png",
"refer_images": [
{"image_url": "https://example.com/side.png"}
]
},
"tag_list": [{"tag_id": "o_102"}]
}'
```
```json 200 theme={null}
{
"id": "863121016086724692",
"task_id": "863121016086724692",
"object": "video",
"model": "kling-element",
"status": "queued",
"progress": 0,
"created_at": 1773812605
}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Use `application/json`.
## Request body
Element name, up to 20 characters.
Element description, up to 100 characters.
`image_refer` for image references or `video_refer` for one reference video.
Required when `reference_type` is `image_refer`.
Front-view image URL or raw Base64 without a data URI prefix.
One to three alternate-angle or close-up images.
Reference image URL or raw Base64.
Required when `reference_type` is `video_refer`.
Exactly one reference video.
Public MP4 or MOV URL. The video must be 3–8 seconds, 1080p, 16:9 or 9:16, and no larger than 200 MB.
Optional voice ID to bind to the element.
Element tags.
`o_101` trend, `o_102` character, `o_103` animal, `o_104` item, `o_105` costume, `o_106` scene, `o_107` effect, or `o_108` other.
Images support JPG, JPEG, and PNG, up to 10 MB each. Both dimensions must be at least 300 px and the aspect ratio must be between 1:2.5 and 2.5:1.
## Create response
AnyFast task ID.
Task ID, identical to `id`.
Object type; currently `video`.
Fixed value `kling-element`.
Initial task status, normally `queued`.
Task progress from 0 to 100.
Creation Unix timestamp.
## Query a custom element
`GET /kling/v1/general/advanced-custom-elements/{task_id}`
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/kling/v1/general/advanced-custom-elements/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY'
```
Task ID returned by the create endpoint.
The result uses `data.task_status` (`submitted`, `processing`, `succeed`, or `failed`). After success, read `data.task_result.elements[]`; each item includes `element_id`, name, description, reference media, optional voice information, tags, ownership, and status.
## List preset elements
`GET /kling/v1/general/advanced-presets-elements?pageNum=1&pageSize=30`
```bash cURL theme={null}
curl --request GET \
--url 'https://www.anyfast.ai/kling/v1/general/advanced-presets-elements?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
Page number from 1 to 1,000.
Items per page from 1 to 500.
The response returns task records in `data[]`. Read each record's preset elements from `task_result.elements[]`. Current preset elements return `owned_by: "vod"`.
This page strictly documents the Kling Legacy element API.
## Voice APIs
| 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 and query
`voice_name` is at most 20 characters. Supply at least one of `voice_url` or `video_id`. A voice URL may point to MP3, WAV, MP4, or MOV containing one clean speaker for 5–30 seconds. A qualifying historical generated video can be supplied through `video_id` under the same audio constraints.
```bash cURL theme={null}
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"
}'
```
```json 200 theme={null}
{"id":"850087542757535834","task_id":"850087542757535834","object":"video","model":"kling-voices","status":"queued","progress":0,"created_at":1773812605}
```
## Request headers
Bearer authentication in the form `Bearer YOUR_API_KEY`.
Data exchange format. Use `application/json`.
## Request parameters
Custom voice name, up to 20 characters.
Public MP3, WAV, MP4, or MOV URL; at least one source is required.
Eligible historical generated-video ID; at least one source is required.
## Create response
AnyFast task ID.
Task ID, identical to `id`.
Object type; currently `video`.
Fixed value `kling-voices`.
Initial task status, normally `queued`.
Task progress from 0 to 100.
Creation Unix timestamp.
### Query custom voice
`GET /kling/v1/general/custom-voices/{id}`
```bash cURL theme={null}
curl --request GET \
--url https://www.anyfast.ai/kling/v1/general/custom-voices/TASK_ID \
--header 'Authorization: Bearer YOUR_API_KEY'
```
Task ID returned by voice creation.
The result uses `data.task_status`. After success, `data.task_result.voices[]` contains `voice_id`, `voice_name`, `trial_url`, `owned_by`, and `status`.
### List preset voices
`GET /kling/v1/general/presets-voices?pageNum=1&pageSize=30`
```bash cURL theme={null}
curl --request GET \
--url 'https://www.anyfast.ai/kling/v1/general/presets-voices?pageNum=1&pageSize=30' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
Page number, 1–1000.
Items per page, 1–1000.
Preset records are returned in `data[]`; read voices from `task_result.voices[]`. Current preset voices return `owned_by: "vod"`.
Open the interactive reference for each voice operation.