Kling 4.0

POST

tasks

Kling 4.0

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

文生、首尾/关键帧图生、多模态参考、视频编辑与延长，始终生成立体声音频。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-v4-example-001" \
  -d '{
  "model": "kling-v4",
  "action": "generate",
  "prompt": "A paper boat drifts slowly on a quiet pond, gentle water sounds",
  "duration": 3,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

提交返回 task_id，使用GET /v1/tasks/{task_id}查询结果。参考素材必须是可公开下载的 URL。

请求参数

参数	类型或取值	说明
model	`kling-v4`	固定模型 ID。
`action`	generate / edit / extend	generate 根据素材选择生成模式；edit 编辑输入视频；extend 延长输入视频。
`prompt`	string	除图生视频外必填。素材可在提示词中用 @Image1、@Video1、@Audio1 引用。
`duration`	integer	生成与延长必填，3–30 秒；编辑可省略或传 0，按提交前探测的源片时长向上取整预扣与结算。延长时指新增片段时长。
`resolution`	720p / 1080p	默认 720p。
`aspect_ratio`	16:9 / 9:16 / 1:1 / 21:9 / auto	参考生成支持 auto；普通文生默认跟随上游 16:9。延长不可传。
`image_urls`	string[]	普通图生按首帧/尾帧顺序传 1–2 张；reference 参考模式和编辑最多 10 张。
`image_with_roles`	object[]	最多 10 项 `{url, role}`，role 可为 first_frame、last_frame、keyframe、middle_frame、reference_image。图生恰好一张首帧，关键帧最多 8 张；与 image_urls、first_frame_image、last_frame_image 二选一。
`first_frame_image / last_frame_image`	string	首尾帧 URL；extend 只接受 last_frame_image 作为目标尾帧。
`video_urls`	string[]	生成最多 5 段参考视频；编辑或延长恰好 1 段。链接必须可读取；本线路每段至少 1 秒，编辑输入至少 3 秒。输入视频总长不得超过 30 秒，超长原片请先裁剪；计费输入时长也封顶 30 秒。
`audio_urls`	string[]	generate 最多 3 段参考音频，每段 5–30 秒。所有参考图、视频与音频合计最多 15 项。
`omni_reference_task_type`	auto / reference	仅 generate；默认 auto，纯多图参考请显式 reference。edit/extend 的模式由 action 固定，不能用本字段切换。
`audio_setting`	origin / auto	编辑或带视频的参考生成可用：origin 保留视频声音，auto 生成新声音。extend 不接受。
`generate_audio`	true	始终有声，false 会在预扣前被拒。
`watermark`	false	不支持开启水印。

不接受旧版 mode、negative_prompt、multi_shot、multi_prompt、element_list、video_list、camera_control、voice_list。输入视频必须可直接读取，每段至少 1 秒。角色与素材组合还须符合上游规则。

编辑视频

{
  "model": "kling-v4",
  "action": "edit",
  "prompt": "Change the scene to warm sunset light, keeping the boat.",
  "video_urls": [
    "https://cdn.example.com/source.mp4"
  ],
  "duration": 3,
  "resolution": "720p"
}

延长视频

{
  "model": "kling-v4",
  "action": "extend",
  "prompt": "Continue the boat drifting slowly on the pond.",
  "video_urls": [
    "https://cdn.example.com/source.mp4"
  ],
  "duration": 3,
  "resolution": "720p"
}

计费与结果

采用固定秒价，报价与结算使用提交时冻结的费率和素材时长。普通生成按输出秒；延长只收新增片段；编辑和带视频参考生成按“输出秒 + max(输出秒, 输入计费秒)”计算。输入计费秒为多段原始时长合计后向上取整、再封顶 30 秒，不逐段取整。视频探测失败会在预扣前拒绝请求。

模式	720p（USD / 秒）	1080p（USD / 秒）
普通生成 / 延长新增片段	$0.1575	$0.23625
编辑 / 带视频参考生成的计费秒	$0.0945	$0.14175

编辑省略 duration 或传 0 时，按已探测源片向上取整，直接计算预扣与结算，不再预扣 30 秒上限。例如 3.04 秒源片按 4 秒输出，计费 4 + max(4, 4) = 8 秒，720p 预扣和成功结算均为 $0.756。输出文件的封装尾帧不会再次增加该任务的计费秒数。历史任务保留提交时的费率。当前单价见控制台模型市场或 GET /v1/models 的 price_config。成功图片返回 result.images，视频返回 result.videos，url 是数组。任务失败或取消，预扣全额退还。最终费用看任务响应 cost（整数 quota，500,000 quota = 1 USD），并确认 billing_status 已 settled。通用回调、等待、幂等和费用上限见提交任务。

Kling 4.0

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

编辑视频

延长视频

计费与结果

​快速开始

​请求参数

​编辑视频

​延长视频

​计费与结果

快速开始

请求参数

编辑视频

延长视频

计费与结果