Kling 2.6图生视频API-可灵AI图片转视频-AutoRouter

{
  "contents": [
    {
      "type": "prompt",
      "text": "一个女孩坐在火车上，望着窗外，神情忧郁，头随着列车轻轻晃动，@1 轻声低语。"
    },
    {
      "type": "first_frame",
      "url": "https://example.com/first.png"
    },
    {
      "type": "voice",
      "voice_id": "891495440020668439",
      "id": "1"
    }
  ],
  "settings": {
    "audio": "native",
    "resolution": "1080p",
    "duration": 5
  },
  "options": {
    "callback_url": "https://xxx/callback",
    "external_task_id": "",
    "watermark_info": {
      "enabled": true
    }
  }
}

Example（首尾帧）：

{
  "contents": [
    {
      "type": "prompt",
      "text": "镜头从近景缓慢拉远"
    },
    {
      "type": "first_frame",
      "url": "https://example.com/first.png"
    },
    {
      "type": "last_frame",
      "url": "https://example.com/last.png"
    }
  ],
  "settings": {
    "resolution": "720p",
    "duration": 5
  }
}

Properties:

Name	Type	Required	Description
`contents`	object[]	Yes	参考输入集合（提示词、图片、音色等）
`contents[].type`	string	Yes	输入类型：`prompt`、`first_frame`、`last_frame`、`voice`
`settings`	object	No	输出配置，如分辨率、时长等
`settings.audio`	string	No	是否生成音频。可选 `native`、`off`，默认 `off`
`settings.resolution`	string	No	视频分辨率。可选 `720p`、`1080p`，默认 `720p`
`settings.duration`	integer	No	视频时长（秒）。可选 `5`、`10`，默认 `5`
`options`	object	No	通用配置，如回调地址、水印等
`options.callback_url`	string	No	任务状态变化时的回调通知地址
`options.external_task_id`	string	No	自定义任务 ID，账号内需唯一
`options.watermark_info`	object	No	是否同时生成带水印结果

contentsobject[]（必选）

参考输入集合，格式示例如下：

[
  {
    "type": "prompt",
    "text": "string"
  },
  {
    "type": "first_frame",
    "url": "string"
  },
  {
    "type": "last_frame",
    "url": "string"
  },
  {
    "type": "voice",
    "voice_id": "string",
    "id": "string"
  }
]

typestring（必选）

输入类型：

prompt：文本提示词
first_frame：首帧图片
last_frame：尾帧图片
voice：音色

type=promptobject（视场景）

{
  "type": "prompt",
  "text": "string"
}

text：提示词内容，最长 2500 字符
可在提示词中通过 @xxx 指定音色，例如 @1、@sweet

type=first_frame / last_frameobject（视场景）

{
  "type": "first_frame",
  "url": "string"
}

首帧（first_frame）必填，尾帧（last_frame）可选
url：图片 URL 或 Base64
格式： .jpg、.jpeg、.png
大小： 不超过 50MB
尺寸： 宽高均不少于 300px；宽高比在 1:2.5 ~ 2.5:1
支持首帧生视频、首尾帧生视频；不支持仅尾帧
使用首尾帧生成时，仅支持 720p 分辨率

type=voiceobject（可选）

{
  "type": "voice",
  "voice_id": "string",
  "id": "string"
}

voice_id：音色 ID（系统预设或自定义音色 API 返回）
id：输入索引 ID，用于在 prompt 中引用（如 @1）；同一任务内不可重复
同一任务最多引用 2 个音色
指定音色时，settings.audio 不能为 off

settingsobject（可选）

输出配置相关参数，如分辨率、时长等。

audiostring（可选）

是否为视频生成音频。默认 off。

native：生成与画面匹配的原生音频；仅支持 1080p
off：无音频；此时不支持指定音色

resolutionstring（可选）

生成视频的分辨率。默认 720p。

720p：输出 720P 视频
1080p：输出 1080P 视频

注意：

开启原生音频时，仅支持 1080p
使用首尾帧生成时，仅支持 720p

durationinteger（可选）

视频时长（秒）。默认 5。

可选值：5、10

optionsobject（可选）

通用配置，如回调地址、是否含水印等。

{
  "callback_url": "https://example.com/cb",
  "external_task_id": "string",
  "watermark_info": {
    "enabled": false
  }
}

callback_urlstring（可选）

任务结果回调地址。配置后，任务状态变化时服务端会发送通知。

external_task_idstring（可选）

自定义任务 ID，不会覆盖系统生成的任务 ID，可用于查询。账号内必须唯一。

watermark_infoobject（可选）

是否同时生成带水印结果。由 enabled 控制：

{
  "enabled": false
}

true：包含带水印结果
false（默认）：不含水印

暂不支持自定义水印。

Responses

200: 成功创建任务

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/kling/image-to-video/kling-2.6" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "contents": [
    {
      "type": "prompt",
      "text": "一个女孩坐在火车上，望着窗外，神情忧郁，头随着列车轻轻晃动。"
    },
    {
      "type": "first_frame",
      "url": "https://example.com/first.png"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "duration": 5
  }
}'

响应示例

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "id": "string",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": "string"
  }
}

响应字段说明：

Name	Type	Description
`code`	integer	错误码，`0` 表示成功
`message`	string	错误信息
`request_id`	string	请求 ID，由系统生成
`data.id`	string	系统生成的任务 ID
`data.status`	string	任务状态：`submitted`、`processing`、`succeeded`、`failed`
`data.create_time`	integer	任务创建时间，Unix 时间戳（毫秒）
`data.update_time`	integer	任务更新时间，Unix 时间戳（毫秒）
`data.external_id`	string	自定义任务 ID（如有）

GET `/kling/tasks`

查询视频生成任务

通过任务 ID 或自定义任务 ID 查询异步任务状态与结果。

task_ids 与 external_task_ids 二选一，不可同时使用
支持批量查询，多个 ID 以 , 分隔
生成结果会在 30 天后清理，请及时保存

Query Params

Name	Type	Required	Description
`task_ids`	string	No	系统生成的任务 ID，多个以 `,` 分隔
`external_task_ids`	string	No	自定义任务 ID，多个以 `,` 分隔

Responses

200: 成功查询任务

Content-Type: application/json

请求示例

curl -X GET "https://api.autorouter.top/kling/tasks?task_ids={id}" \
  -H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "string",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "string",
      "outputs": [
        {
          "type": "video",
          "id": "string",
          "url": "string",
          "watermark_url": "string",
          "duration": "string"
        },
        {
          "type": "image",
          "url": "string",
          "watermark_url": "string",
          "group_id": "string"
        },
        {
          "type": "audio",
          "id": "string",
          "mp3_url": "string",
          "wav_url": "string",
          "mp3_duration": "string",
          "wav_duration": "string"
        },
        {
          "type": "voice",
          "id": "string",
          "name": "string",
          "url": "string",
          "owned_by": "string",
          "status": "succeeded"
        },
        {
          "type": "element",
          "id": "string",
          "name": "string",
          "description": "string",
          "element_type": "string",
          "references": [
            {
              "type": "image",
              "role": "string",
              "url": "string"
            },
            {
              "type": "video",
              "role": "refer",
              "url": "string"
            },
            {
              "type": "voice",
              "role": "refer",
              "url": "string",
              "id": "string",
              "name": "string",
              "owned_by": "string"
            }
          ],
          "owned_by": "string",
          "status": "string",
          "tags": [
            {
              "id": 1,
              "name": "string",
              "description": "string"
            }
          ]
        }
      ],
      "billing": [
        {
          "charge_type": "string",
          "cash_type": "string",
          "amount": "string",
          "package_type": "string",
          "list_price": "string"
        }
      ]
    }
  ]
}

响应字段说明：

Name	Type	Description
`code`	integer	错误码，`0` 表示成功
`message`	string	错误信息
`request_id`	string	请求 ID，由系统生成，用于追踪与排查
`data`	object[]	任务列表
`data[].id`	string	被查询的任务 ID
`data[].status`	string	任务状态：`submitted`、`processing`、`succeeded`、`failed`
`data[].message`	string	任务状态信息；失败时展示失败原因（如触发内容风控）
`data[].create_time`	integer	任务创建时间，Unix 时间戳（毫秒）
`data[].update_time`	integer	任务更新时间，Unix 时间戳（毫秒）
`data[].external_id`	string	自定义任务 ID（如有）
`data[].outputs`	object[]	生成结果列表；字段随 `type` 变化
`data[].billing`	object[]	计费明细

statusstring

任务状态：

submitted：已提交
processing：处理中
succeeded：成功
failed：失败

建议轮询间隔 3～5 秒，直到 status 为 succeeded 或 failed。

outputsobject[]

生成结果列表。type 决定返回字段，可选值：image、video、audio、element、voice。图生视频成功时通常返回 type=video。

type=videoobject

Name	Type	Description
`type`	string	固定为 `video`
`id`	string	视频 ID，由系统生成
`url`	string	生成结果 URL（防盗链格式；约 30 天后清理，请及时保存）
`watermark_url`	string	带水印结果 URL（防盗链格式）
`duration`	string	生成视频时长（秒）

type=imageobject

Name	Type	Description
`type`	string	固定为 `image`
`url`	string	生成结果 URL（防盗链格式；约 30 天后清理）
`watermark_url`	string	带水印图片下载 URL（防盗链格式）
`group_id`	string	仅分组出图时出现，用于标记分组关系

type=audioobject

Name	Type	Description
`type`	string	固定为 `audio`
`id`	string	音频 ID，由系统生成
`mp3_url`	string	MP3 结果 URL（防盗链格式；约 30 天后清理）
`wav_url`	string	WAV 结果 URL（防盗链格式；约 30 天后清理）
`mp3_duration`	string	MP3 时长（秒）
`wav_duration`	string	WAV 时长（秒）

type=voiceobject

Name	Type	Description
`type`	string	固定为 `voice`
`id`	string	音频 ID，由系统生成
`name`	string	音频名称
`url`	string	素材下载链接
`owned_by`	string	音色来源：`kling` 为官方音色库，数字为创作者 ID
`status`	string	状态：`succeeded`、`deleted`

type=elementobject

Name	Type	Description
`type`	string	固定为 `element`
`id`	string	元素 ID，由系统生成
`name`	string	元素名称
`description`	string	元素描述
`element_type`	string	元素类型：`video_character_elements`、`multi_image_elements`
`references`	object[]	元素相关素材
`references[].type`	string	素材类型：`image`、`video`、`voice`
`references[].role`	string	素材属性；图片为 `frontal` / `reference`，视频与音色为 `refer`
`references[].url`	string	素材下载链接
`references[].id`	string	音色 ID（`type=voice` 时）
`references[].name`	string	音色名称（`type=voice` 时）
`references[].owned_by`	string	音色来源（`type=voice` 时）
`owned_by`	string	元素来源：`kling` 为官方库，数字为创作者 ID
`status`	string	状态：`succeeded`、`deleted`
`tags`	object[]	元素标签
`tags[].id`	integer	标签 ID
`tags[].name`	string	标签名称
`tags[].description`	string	标签描述

billingobject[]

计费明细。

charge_typestring

消耗账户类型：

cash：余额扣费
unit：资源包扣费

cash_typestring

余额类型，仅 charge_type=cash 时存在：

balance：正式额度
test_balance：测试额度

amountstring

扣费金额。charge_type=cash 时为余额折扣价；charge_type=unit 时为资源包扣减单位数（十进制字符串）。

package_typestring

资源包类型，仅 charge_type=unit 时存在。固定枚举：video、image、audio。

list_pricestring

余额扣费标价，仅 charge_type=cash 时存在。

错误处理

HTTP 400 参数错误

场景	处理建议
未传首帧图片	至少提供 1 个 `type=first_frame`
仅传尾帧	不支持仅尾帧，须包含首帧
首尾帧 + 非 720p	将 `settings.resolution` 设为 `720p`
指定音色但 `audio=off`	将 `settings.audio` 设为 `native`
原生音频 + 非 1080p	将 `settings.resolution` 设为 `1080p`
图片格式 / 尺寸不合规	参考 `first_frame` / `last_frame` 限制

HTTP 401 / 403 鉴权错误

401 Unauthorized：API Key 无效或已过期
403 Forbidden：API Key 无权访问此模型

HTTP 402 余额不足

返回余额不足错误。请前往 AutoRouter 控制台充值。

任务 `failed` 状态

原因	处理建议
内容审核失败	调整提示词或更换参考图
图片 URL 不可访问	确保公网可访问，或改用 Base64
参数组合非法	按 Request Body 规范传参

任务失败时 AutoRouter 会自动退款到你的账户。

图生视频