API 参考

Kling Image-to-Video

创建文生视频任务，并跟踪其完成或失败状态。

查看 Markdown

概览

使用支持的模型创建异步文生视频任务。使用返回的任务 ID 查询状态，或提供 callback_url 接收终态投递。

快速开始

创建 API Key，并将其设置为 RUNAPI_API_KEY。
选择一个支持的模型，并发送与该模型 Schema 匹配的 POST 请求。
保存返回的任务 ID，随后轮询到终态，或处理终态回调。

POST /api/v1/kling/image_to_video

基础 URL: https://runapi.ai
API 版本: v1
身份验证: Authorization: Bearer YOUR_API_TOKEN

支持的模型

打开模型页可查看当前价格、限流和商业使用详情。

请求 Schema

JSON 请求体

字段和允许的取值取决于所选模型。提供 callback_url 后，它会收到任务终态投递。

kling-o113 个字段

aspect_ratiostring

可选

Output aspect ratio.

可选值: 16:9, 9:16, 1:1 默认值: 16:9

callback_urlstring

可选

Webhook URL for async notifications.

duration_secondsinteger

可选

Duration in seconds.

可选值: 5 默认值: 5

enable_soundboolean

可选

Sound generation must remain disabled.

默认值: false

first_frame_image_urlstring

必填

Public HTTP(S) JPG, JPEG, or PNG first-frame image URL.

last_frame_image_urlstring

可选

Public HTTP(S) JPG, JPEG, or PNG final-frame image URL; cannot be combined with reference_image_urls or reference_video_url.

modestring

可选

Generation mode.

可选值: std, pro 默认值: std

modelstring

必填

Model slug.

preserve_reference_video_audioboolean

可选

Preserve the reference video's original audio.

默认值: false

promptstring

必填

Video description; reference media with matching numbered markers.

范围: 1 - 2500

reference_image_urlsarray

可选

Ordered public HTTP(S) JPG, JPEG, or PNG reference image URLs; cannot be combined with last_frame_image_url.

reference_video_typestring

可选

Use the video as a base edit or feature reference.

可选值: base, feature 默认值: base

reference_video_urlstring

可选

Public HTTP(S) MP4 or MOV reference video URL; cannot be combined with last_frame_image_url.

kling-v2.1-master-image-to-video9 个字段

aspect_ratiostring

可选

Output aspect ratio.

callback_urlstring

可选

Webhook URL for async notifications.

cfg_scalenumber

可选

Guidance scale (0-1).

duration_secondsinteger

可选

Duration in seconds.

可选值: 5, 10

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL for supported image-to-video models.

modelstring

必填

Model slug.

negative_promptstring

可选

Negative prompt.

promptstring

必填

Video description.

kling-v2.1-pro9 个字段

aspect_ratiostring

可选

Output aspect ratio.

callback_urlstring

可选

Webhook URL for async notifications.

cfg_scalenumber

可选

Guidance scale (0-1).

duration_secondsinteger

可选

Duration in seconds.

可选值: 5, 10

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL for supported image-to-video models.

modelstring

必填

Model slug.

negative_promptstring

可选

Negative prompt.

promptstring

必填

Video description.

kling-v2.1-standard9 个字段

aspect_ratiostring

可选

Output aspect ratio.

callback_urlstring

可选

Webhook URL for async notifications.

cfg_scalenumber

可选

Guidance scale (0-1).

duration_secondsinteger

可选

Duration in seconds.

可选值: 5, 10

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL for supported image-to-video models.

modelstring

必填

Model slug.

negative_promptstring

可选

Negative prompt.

promptstring

必填

Video description.

kling-v2.5-turbo-image-to-video-pro9 个字段

aspect_ratiostring

可选

Output aspect ratio.

callback_urlstring

可选

Webhook URL for async notifications.

cfg_scalenumber

可选

Guidance scale (0-1).

duration_secondsinteger

可选

Duration in seconds.

可选值: 5, 10

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL for supported image-to-video models.

modelstring

必填

Model slug.

negative_promptstring

可选

Negative prompt.

promptstring

必填

Video description.

kling-v2.69 个字段

aspect_ratiostring

可选

Output aspect ratio.

可选值: 16:9, 9:16, 1:1 默认值: 16:9

callback_urlstring

可选

Webhook URL for async notifications.

duration_secondsinteger

可选

Duration in seconds.

可选值: 5, 10 默认值: 5

enable_soundboolean

可选

Enable sound generation; requires pro mode.

默认值: false

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL; requires pro mode and 5 seconds.

modestring

可选

Generation mode.

可选值: std, pro 默认值: std

modelstring

必填

Model slug.

promptstring

必填

Video description.

范围: 1 - 2500

kling-v3-omni9 个字段

aspect_ratiostring

可选

Output aspect ratio.

可选值: 16:9, 9:16, 1:1 默认值: 16:9

callback_urlstring

可选

Webhook URL for async notifications.

duration_secondsinteger

可选

Duration in seconds.

可选值: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 默认值: 5

enable_soundboolean

可选

Enable synchronized sound generation.

默认值: false

first_frame_image_urlstring

必填

First frame image URL.

last_frame_image_urlstring

可选

Final frame image URL; requires a 5-second duration.

modelstring

必填

Model slug.

output_resolutionstring

可选

Output resolution.

可选值: 720p, 1080p, 4k 默认值: 720p

promptstring

必填

Video description.

范围: 1 - 2500

kling-v3-turbo-image-to-video6 个字段

callback_urlstring

可选

Webhook URL for async notifications.

duration_secondsinteger

可选

Duration in seconds.

可选值: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 默认值: 5

first_frame_image_urlstring

必填

First frame image URL.

modelstring

必填

Model slug.

output_resolutionstring

可选

Output resolution.

可选值: 720p, 1080p 默认值: 720p

promptstring

必填

Video description.

范围: 1 - 2500

创建已接受

HTTP 202

POST /api/v1/kling/image_to_video

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

轮询处理中

HTTP 200

GET /api/v1/kling/image_to_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

轮询已完成

HTTP 200

GET /api/v1/kling/image_to_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

轮询失败

HTTP 200

GET /api/v1/kling/image_to_video/:id

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

客户回调：已完成

HTTP 200

POST callback_url

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

客户回调：失败

HTTP 200

POST callback_url

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

错误

HTTP 400

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "A required request field is missing."
  }
}

生成的代码示例

直接使用 cURL，或安装所用语言的 SDK。每个示例都会提交本参考中经过验证的请求。

CURL

curl -X POST https://runapi.ai/api/v1/kling/image_to_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"kling-o1","prompt":"A gentle camera pan across the scene.","first_frame_image_url":"https://file.runapi.ai/first-frame.png"}'

Kling Image-to-Video

概览

快速开始

端点

支持的模型

请求 Schema

创建已接受

轮询处理中

轮询已完成

轮询失败

客户回调：已完成

客户回调：失败

错误

生成的代码示例

相关指南