Subject-Controlled Video Generation (kling-v3)

POST

https://api.tokenhot.ai/v1/video/generations

Actual request URL: POST https://api.tokenhot.ai/v1/video/generations

Model: kling-v3

Generate video referencing an element_id obtained from "Create Subject" to maintain character/object consistency. Pass subject IDs via the subject_infos array; reference the first subject in the prompt with <<<element_1>>> (mapped in array order as element_1 / element_2 ...).

Can be combined with ext_info for multi-shot.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tokenhot.ai/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "kling-v3",
    "prompt": "<<<element_1>>> sits on a park bench as sunlight filters through the leaves. Then cut to a car speeding in the rain",
    "duration": 5,
    "size": "1080P",
    "aspect_ratio": "16:9",
    "enhance_prompt": "Enabled",
    "audio_generation": true,
    "subject_infos": [
        {
            "Id": "858477278396170315"
        },
        {
            "Id": "858477602846711835"
        }
    ],
    "ext_info": "{\"AdditionalParameters\": \"{\\\"multi_shot\\\": true, \\\"shot_type\\\": \\\"customize\\\", \\\"multi_prompt\\\": [{\\\"index\\\": 1, \\\"prompt\\\": \\\"A person sitting on a park bench as sunlight filters through the leaves\\\", \\\"duration\\\": 2}, {\\\"index\\\": 2, \\\"prompt\\\": \\\"A car speeding in the rain, headlights flashing. Dynamic angle, emphasizing motion.\\\", \\\"duration\\\": 3}]}\"}"
}'

Response Example

{}

Modified at 2026-06-23 06:57:44

First/Last Frame Video Generation (kling-v3)

Text-to-Video (kling-v3-omni)