kling-v3
Submit an async Kling v3 video generation task. Returns a task_id to poll via the status endpoint.
Authorization
BearerAuth
AuthorizationBearer <token>
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
In: header
Request Body
application/json
model*string
Kling 模型名。
Value in
"kling-v3"prompt*string
视频描述，必填。图生视频时用于描述动作和镜头变化。
negative_prompt?string
负面提示词，描述应避免的内容。
aspect_ratio?string
视频比例。
Value in
"16:9" | "9:16" | "1:1"quality?string
视频清晰度。
Value in
"720p" | "1080p" | "4k"duration?integer
视频时长，单位为秒。范围 3..15，默认 5。
Range
3 <= value <= 15generate_audio?boolean
是否生成音轨。true 表示生成，false 表示不生成。
images?array<string>
参考图列表。1 张作首帧；2 张作首末帧插值。
Items
items <= 2model_params?object
高级生成参数，可配置多镜头、分镜提示词、元素和水印。
multi_shot?boolean
shot_type?string
Value in
"customize" | "intelligence"multi_prompt?array<object>
Items
items <= 6Array Item (object)
index?integer
prompt?string
duration?integer
element_list?array<unknown>
watermark_info?object
enabled?boolean
[key: string]?never
[key: string]?never
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.apimp.ai/api/generate/submit" \ -H "Content-Type: application/json" \ -d '{ "model": "kling-v3", "prompt": "A cat running on a grass field under bright sunshine" }'{
"code": 200,
"data": {
"task_id": "task_2BvCWmHzG6sJxK4tQpAr8M9nZyYfRdLs",
"status": "not_started",
"created_time": "2026-07-08T09:21:26",
"error_message": null
}
}{
"code": 400,
"error": {
"message": "field `prompt` is required",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "string",
"type": "invalid_request_error"
}
}How is this guide?
Last updated on