Kling 3.0 Turbo

Kling 3.0 Turbo 支持文生视频和图生视频。两种能力使用不同的创建任务接口，任务创建成功后均通过任务 ID 查询状态和视频结果。

文生视频

创建任务

项目	值
请求方法	`POST`
请求地址	`https://token.aiznt.com/text-to-video/kling-3.0-turbo`
认证方式	Header `Authorization: Bearer sk-你的密钥`
Content-Type	`application/json`

curl https://token.aiznt.com/text-to-video/kling-3.0-turbo \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "一位女孩坐在火车上望向窗外，神情忧郁，头部随着火车轻轻晃动",
  "settings": {
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "duration": 3
  },
  "options": {
    "external_task_id": "text-task-001",
    "watermark_info": {
      "enabled": false
    }
  }
}'

请求参数

字段	类型	必填	默认值	可选值	说明
`prompt`	string	是	—	—	文本提示词，可包含正向描述和负向描述；不超过 3072 个字符，建议不超过 2500 个字符。
`settings`	object	否	—	—	输出清晰度、画面比例和时长设置。
`settings.resolution`	string	否	`720p`	`720p`、`1080p`	生成视频的清晰度。
`settings.aspect_ratio`	string	否	`16:9`	`16:9`、`9:16`、`1:1`	生成视频的画面宽高比。
`settings.duration`	integer	否	`5`	`3`～`15`	视频时长，单位为秒。
`options`	object	否	—	—	回调、自定义任务 ID 和水印设置。
`options.callback_url`	string	否	—	—	任务状态变化时接收通知的回调地址。
`options.external_task_id`	string	否	—	—	账户内唯一的自定义任务 ID，可用于查询。
`options.watermark_info`	object	否	—	—	水印配置对象。
`options.watermark_info.enabled`	boolean	否	`false`	—	是否生成含水印结果。

可使用“镜头 n, m, words;”格式生成多镜头视频，最多 6 个镜头。每个镜头至少 1 秒，所有镜头时长之和必须等于 settings.duration，单个镜头提示词最长 512 个字符。

创建任务响应

创建任务成功后返回系统任务 ID。status 初始为 submitted，之后可能变为 processing、succeeded 或 failed。

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080794151,
    "external_id": "text-task-001"
  }
}

字段	类型	说明
`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（如有）。

查询任务（按任务 ID）

GET https://token.aiznt.com/tasks。task_ids 与 external_task_ids 至少且只能选择一个，支持用英文逗号分隔多个 ID。

查询参数	类型	必填	说明
`task_ids`	string	二选一	系统任务 ID；批量查询时用英文逗号分隔。
`external_task_ids`	string	二选一	自定义任务 ID；批量查询时用英文逗号分隔。

curl "https://token.aiznt.com/tasks?external_task_ids=text-task-001" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json"

查询响应

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "string",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "text-task-001",
      "outputs": [
        {
          "type": "video",
          "id": "video-output-id",
          "url": "string",
          "watermark_url": "string",
          "duration": "10"
        }
      ],
      "billing": [
        {
          "charge_type": "unit",
          "amount": "1",
          "package_type": "video"
        }
      ]
    }
  ]
}

字段	类型	说明
`data`	array	查询到的任务列表。
`data[].id`	string	被查询的系统任务 ID。
`data[].status`	string	任务状态；失败时为 `failed`。
`data[].message`	string	任务状态信息，失败时可包含内容风控等原因。
`data[].create_time` / `update_time`	integer	任务创建/更新时间，Unix 毫秒时间戳。
`data[].external_id`	string	自定义任务 ID（如有）。
`data[].outputs`	array	生成结果列表。视频任务通常返回 `type=video`。
`data[].outputs[].type`	string	输出类型；视频为 `video`。
`data[].outputs[].id`	string	视频结果 ID。
`data[].outputs[].url`	string	视频下载 URL，防盗链格式。
`data[].outputs[].watermark_url`	string	含水印视频下载 URL。
`data[].outputs[].duration`	string	视频时长，单位为秒。
`data[].billing`	array	扣费明细。

视频 URL 会在 30 天后清理，请在任务成功后及时转存。

除视频外，通用任务查询的 outputs[] 还可能返回以下类型：

image：url、watermark_url、group_id。
audio：id、mp3_url、wav_url、mp3_duration、wav_duration。
voice：id、name、url、owned_by、status。
element：id、name、description、element_type、references、owned_by、status、tags。

billing[] 可包含 charge_type、cash_type、amount、currency、package_type 和 list_price。

按游标查询

POST https://token.aiznt.com/tasks

仅支持查询非实时的异步任务。首次查询可使用时间范围和筛选条件；后续分页时，将上一页响应中的 data.next_cursor 作为 cursor 传入。传入 cursor 后，start_time 和 end_time 不再生效。

字段	类型	默认值	说明
`start_time`	string	`end_time` 前 30 天	创建时间范围起点，Unix 毫秒时间戳；必须早于 `end_time`。
`end_time`	string	当前时间	创建时间范围终点，Unix 毫秒时间戳。
`cursor`	string	—	上次响应的 `data.next_cursor`；传入后忽略时间范围。
`limit`	integer	`100`	返回任务数量，最大 500。
`filters`	array	—	查询筛选条件。
`filters[].key`	string	—	`status` 或 `product_type`。
`filters[].values`	array	—	`status` 支持 `submitted`、`processing`、`succeeded`、`failed`；`product_type` 支持 `video`、`image`、`try_on`。

curl https://token.aiznt.com/tasks \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
  "limit": 100,
  "filters": [
    {
      "key": "product_type",
      "values": [
        "video"
      ]
    }
  ]
}'

响应位于 data.result，同时返回 data.count、data.next_cursor 和 data.has_more；result[] 字段与按任务 ID 查询一致。需要下一页时，将 data.next_cursor 放入下一次请求的 cursor，例如：

{
  "cursor": "上一次响应中的 data.next_cursor",
  "limit": 100,
  "filters": [
    {
      "key": "product_type",
      "values": ["video"]
    }
  ]
}