APIMPAPIMP
用户指南AI 接口图片接口视频接口公共接口

kling-v3

提交 Kling v3 异步视频生成任务，返回 task_id 后通过状态查询接口轮询。

POST
/api/generate/submit

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。

Range3 <= value <= 15
generate_audio?boolean

是否生成音轨。true 表示生成，false 表示不生成。

images?array<string>

参考图列表。1 张作首帧；2 张作首末帧插值。

Itemsitems <= 2
model_params?object

高级生成参数，可配置多镜头、分镜提示词、元素和水印。

multi_shot?boolean
shot_type?string
Value in"customize" | "intelligence"
multi_prompt?array<object>
Itemsitems <= 6
Array 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"
  }
}

这篇文档对您有帮助吗？

最后更新于