kling-v2-1

本页整合 Kling 2.1 的图生视频和相应的任务查询。每个能力的请求、响应及字段说明均在对应 Tab 中。

图生视频

创建任务

POST /kling/v1/videos/image2video

cURL

curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/image2video \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-2.1",
    "image": "https://example.com/start.png",
    "image_tail": "https://example.com/end.png",
    "prompt": "主体转身看向窗外",
    "duration": "5",
    "mode": "std",
    "watermark_info": {"enabled": false}
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

请求体

string

必填

固定为 kling-2.1。

string

必填

首帧图片 URL 或原始 Base64。

string

可选尾帧；首尾帧生成需要使用 1080p pro 模式。

string

正向提示词，最多 2,500 个字符。

string

负向提示词，最多 2,500 个字符。

string

默认值:"std"

std 为 720p，pro 为 1080p。

string

默认值:"5"

5 或 10 秒。

object

设置 enabled 可请求额外的带水印结果。

图片要求

使用公网 URL 或不带 data URI 前缀的原始 Base64。支持 JPG、JPEG 和 PNG；文件不超过 10 MB，两边至少 300 px，宽高比在 1:2.5 至 2.5:1 之间。

创建响应

200

{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v2-1",
  "status": "queued",
  "progress": 0,
  "created_at": 1773130665
}

string

AnyFast 任务 ID。

string

任务 ID，与 id 相同。

string

对象类型，固定为 video。

string

实际使用的公开模型 ID。

string

初始状态，固定为 queued。

integer

初始进度，固定为 0。

integer

创建时间，Unix 秒级时间戳。

按 ID 查询任务

GET /kling/v1/videos/image2video/{task_id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/kling/v1/videos/image2video/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式，使用 application/json。

路径参数

string

必填

创建接口返回的图生视频任务 ID。

任务结果

200

{
  "code": 0,
  "message": "",
  "data": {
    "task_id": "asyntask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "task_status": "succeed",
    "task_result": {
      "videos": [
        {"url": "https://example.com/result.mp4", "duration": "5"}
      ]
    },
    "created_at": 1784720890000,
    "updated_at": 1784720949000
  }
}

integer

0 表示查询成功。

string

错误信息；成功时为空。

string

查询的任务 ID。

string

submitted、processing、succeed 或 failed。

string

任务失败时的错误详情。

object[]

成功后返回的生成视频。

string

临时视频下载 URL。

string

实际视频时长，单位为秒。

integer

创建时间，Unix 毫秒级时间戳。

integer

更新时间，Unix 毫秒级时间戳。

生成结果 URL 会在 30 天后删除，请及时下载保存。

Kling 2.1 不提供文生视频，也不支持音频、指定音色、多镜头、运动笔刷、镜头控制或 cfg_scale。

概览

原生兼容端点

模型 API

创建任务

请求头

请求体

图片要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果

​创建任务

​请求头

​请求体

​图片要求

​创建响应

​按 ID 查询任务

​请求头

​路径参数

​任务结果

创建任务

请求头

请求体

图片要求

创建响应

按 ID 查询任务

请求头

路径参数

任务结果