Kling3.0(多图生视频)
任务进度与结果查询见 使用说明。
说明
异步任务接口,用于提交 Kling3.0(多图生视频)任务,支持传入 1-7 张参考图片,具体生成进度与结果请通过任务查询接口获取。
请求地址
http
POST /open/v1/ai_creation/task/submitHeader
http
access_token: {{access_token}}
Content-Type: application/json请求参数 Body
json
{
"ref_img_url": [
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-1.jpg",
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-2.jpg"
],
"ref_prompt": "让画面中的人物自然转身,镜头缓慢推进,电影质感",
"creation_type": 4,
"aspect_ratio": "9:16",
"clarity": 1080,
"video_duration": 5,
"model_code": "tx_kling-v3-0-image2video"
}参数说明
| 字段 | 类型 | 是否必传 | 示例 | 说明 |
|---|---|---|---|---|
| ref_img_url | array<string> | 是 | ["https://.../ref-1.jpg","https://.../ref-2.jpg"] | 参考图片 URL 列表,支持 1-7 张 |
| start_frame | string | 否 | https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg | 兼容旧版单图字段,新接入请使用 ref_img_url |
| ref_prompt | string | 是 | 让画面中的人物自然转身,镜头缓慢推进,电影质感 | 视频生成提示词 |
| creation_type | int | 是 | 4 | 创作类型,视频生成为 4 |
| aspect_ratio | string | 是 | 9:16 | 输出视频宽高比,支持 auto、16:9、1:1、9:16 |
| clarity | int/string | 否 | 1080 | 输出清晰度,支持 720、1080、1440、2160;也可传 2K、4K,分别等价于 1440、2160 |
| video_duration | int | 是 | 5 | 视频时长(秒),支持 5-15 |
| model_code | string | 是 | tx_kling-v3-0-image2video | 模型编码,固定为 tx_kling-v3-0-image2video |
响应示例
json
{
"trace_id": "96afa792520b0e6a86d72e89435bc0a7",
"code": 0,
"msg": "success",
"data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}响应字段说明
| 字段 | 说明 |
|---|---|
| code | 响应状态码 |
| msg | 响应信息 |
| trace_id | 请求链路追踪 ID |
| data | 提交的创作 ID |
响应状态码说明
| code | 说明 |
|---|---|
| 0 | 响应成功 |
| 400 | 传入参数格式错误 |
| 10400 | AccessToken 验证失败 |
| 40000 | 参数错误 |
| 40001 | 超出 QPS 限制 |
| 50000 | 系统内部错误 |
示例代码
shell
curl --location --request POST 'https://open-api.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"ref_img_url": [
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-1.jpg",
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-2.jpg"
],
"ref_prompt": "让画面中的人物自然转身,镜头缓慢推进,电影质感",
"creation_type": 4,
"aspect_ratio": "9:16",
"clarity": 1080,
"video_duration": 5,
"model_code": "tx_kling-v3-0-image2video"
}'go
payload := strings.NewReader(`{
"ref_img_url": [
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-1.jpg",
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-2.jpg"
],
"ref_prompt": "让画面中的人物自然转身,镜头缓慢推进,电影质感",
"creation_type": 4,
"aspect_ratio": "9:16",
"clarity": 1080,
"video_duration": 5,
"model_code": "tx_kling-v3-0-image2video"
}`)java
RequestBody body = RequestBody.create(mediaType, "{\n \"ref_img_url\": [\n \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-1.jpg\",\n \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-2.jpg\"\n ],\n \"ref_prompt\": \"让画面中的人物自然转身,镜头缓慢推进,电影质感\",\n \"creation_type\": 4,\n \"aspect_ratio\": \"9:16\",\n \"clarity\": 1080,\n \"video_duration\": 5,\n \"model_code\": \"tx_kling-v3-0-image2video\"\n}");py
payload = json.dumps({
"ref_img_url": [
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-1.jpg",
"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref-2.jpg"
],
"ref_prompt": "让画面中的人物自然转身,镜头缓慢推进,电影质感",
"creation_type": 4,
"aspect_ratio": "9:16",
"clarity": 1080,
"video_duration": 5,
"model_code": "tx_kling-v3-0-image2video"
})