Skip to content

腾讯 Kling 2.5 视频生成

说明

异步任务接口,用于提交腾讯通道 Kling 2.5 视频生成任务,支持文生视频与图生视频,具体生成进度与结果请通过任务查询接口获取。

请求地址

http
POST /open/v1/ai_creation/task/submit
http
access_token: {{access_token}}
Content-Type: application/json

请求参数 Body

json
{
  "start_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg",
  "end_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg",
  "ref_prompt": "未来城市夜景穿梭镜头,光轨拖尾,节奏快速",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "quality_mode": "pro",
  "video_duration": 5,
  "model_code": "tx_kling2.5"
}

参数说明

字段类型是否必传示例说明
start_framestringhttps://.../start.jpg可选首帧
end_framestringhttps://.../end.jpg可选尾帧
ref_promptstring未来城市夜景穿梭镜头,光轨拖尾,节奏快速提示词;不传时服务端使用默认提示词
creation_typeint4创作类型,视频生成为 4
aspect_ratiostring16:9输出视频宽高比
clarityint1080输出清晰度,常用 7201080
quality_modestringpro质量模式,传 pro 时会优先按高质量策略处理
video_durationint5视频时长(秒)
model_codestringtx_kling2.5模型编码,固定为 tx_kling2.5

响应示例

json
{
  "trace_id": "96afa792520b0e6a86d72e89435bc0a7",
  "code": 0,
  "msg": "success",
  "data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}

响应字段说明

字段说明
code响应状态码
msg响应信息
trace_id请求链路追踪 ID
data提交的创作 ID

响应状态码说明

code说明
0响应成功
400传入参数格式错误
10400AccessToken 验证失败
40000参数错误
40001超出 QPS 限制
50000系统内部错误

示例代码

shell
curl --location --request POST 'https://www.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ref_prompt": "未来城市夜景穿梭镜头,光轨拖尾,节奏快速",
    "creation_type": 4,
    "aspect_ratio": "16:9",
    "clarity": 1080,
    "quality_mode": "pro",
    "video_duration": 5,
    "model_code": "tx_kling2.5"
}'
go
payload := strings.NewReader(`{
  "ref_prompt": "未来城市夜景穿梭镜头,光轨拖尾,节奏快速",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "quality_mode": "pro",
  "video_duration": 5,
  "model_code": "tx_kling2.5"
}`)
java
RequestBody body = RequestBody.create(mediaType, "{\n  \"ref_prompt\": \"未来城市夜景穿梭镜头,光轨拖尾,节奏快速\",\n  \"creation_type\": 4,\n  \"aspect_ratio\": \"16:9\",\n  \"clarity\": 1080,\n  \"quality_mode\": \"pro\",\n  \"video_duration\": 5,\n  \"model_code\": \"tx_kling2.5\"\n}");
py
payload = json.dumps({
  "ref_prompt": "未来城市夜景穿梭镜头,光轨拖尾,节奏快速",
  "creation_type": 4,
  "aspect_ratio": "16:9",
  "clarity": 1080,
  "quality_mode": "pro",
  "video_duration": 5,
  "model_code": "tx_kling2.5"
})