Kling 3.0 API

Kling 3.0 适合动作表现、产品运动镜头以及首尾帧控制的视频生成。

模型 key

• kling/kling-v3 — Kling V3

支持的 mode 与输入

模型	Mode	名称	输入要求
kling/kling-v3	text_to_video	文生视频	Prompt max 2000 chars
kling/kling-v3	frames_to_video	首尾帧生成视频	Prompt max 2000 chars Images start_frame,end_frame: 1-2 files, 10 MB, formats jpg, png, webp

参数

模型	参数	默认值	可选值	适用 mode
kling/kling-v3	duration	5s	5s, 10s, 15s	text_to_video
kling/kling-v3	frames_to_video_duration → duration	5s	5s, 10s	frames_to_video
kling/kling-v3	resolution	std	std, pro	全部 mode
kling/kling-v3	aspect_ratio	16:9	16:9, 9:16, 1:1	全部 mode
kling/kling-v3	audio	false	false, true	全部 mode

价格

模型	价格
kling/kling-v3	每秒 1 credit；参数倍率：audio={"true":1.5,"false":1}, resolution={"pro":6,"std":4}

生产建议

• 显式传入 mode。
• 只使用上表列出的参数值。
• 媒体输入类 mode 请先用 POST /api/v1/files 上传素材。
• 如果页面包含多个变体，请使用你真正需要的模型 key。

示例：文生视频

curl https://img2vid.net/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling/kling-v3",
    "mode": "text_to_video",
    "prompt": "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    "duration": "5s",
    "resolution": "std",
    "aspect_ratio": "16:9",
    "audio": "false"
  }'

示例：素材驱动视频

curl https://img2vid.net/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling/kling-v3",
    "mode": "frames_to_video",
    "prompt": "Animate the source into a polished cinematic motion shot with natural camera movement",
    "start_frame": "https://example.com/start.png",
    "duration": "5s",
    "resolution": "std",
    "aspect_ratio": "16:9",
    "audio": "false"
  }'

SDK 示例

下面的示例使用本页的公开模型 key、mode 和参数值。片段假设你已经按快速开始初始化了 SDK client，并引入了对应语言需要的 SDK 类型。媒体输入类 mode 仍然需要先上传本地文件，再把返回的 URL 放入 image_urls、start_frame、video_urls 等公开字段。

JavaScript / TypeScript

const task = await buble.generations.create({
  model: 'kling/kling-v3',
  mode: 'text_to_video',
  prompt:
    'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
  duration: '5s',
  resolution: 'std',
  aspect_ratio: '16:9',
  audio: 'false',
});

const result = await buble.generations.wait(task.data.id);
console.log(result.data.result?.videos?.[0]?.url);

Python

task = client.generations.create(
    model="kling/kling-v3",
    mode="text_to_video",
    prompt="A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    duration="5s",
    resolution="std",
    aspect_ratio="16:9",
    audio="false",
)

result = client.generations.wait(task["data"]["id"])
print(result["data"]["result"]["videos"][0]["url"])

Go

task, err := client.Generations.Create(ctx, &buble.CreateGenerationRequest{
	Model:  "kling/kling-v3",
	Mode:   "text_to_video",
	Prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
	Params: map[string]any{
		"duration": "5s",
		"resolution": "std",
		"aspect_ratio": "16:9",
		"audio": "false",
	},
})
if err != nil {
	return err
}

result, err := client.Generations.Wait(ctx, task.Data.ID)
if err != nil {
	return err
}
fmt.Println(result.Data.Result.Videos[0].URL)

Rust

let task = client.generations().create(
    CreateGenerationRequest::new("kling/kling-v3")
        .mode("text_to_video")
        .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
        .param("duration", "5s")?
        .param("resolution", "std")?
        .param("aspect_ratio", "16:9")?
        .param("audio", "false")?,
).await?;

let result = client
    .generations()
    .wait(&task.data.id, WaitOptions::default())
    .await?;

Swift

let task = try await client.generations.create(
    try CreateGenerationRequest(model: "kling/kling-v3")
        .mode("text_to_video")
        .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
        .param("duration", "5s")
        .param("resolution", "std")
        .param("aspect_ratio", "16:9")
        .param("audio", "false")
)

let result = try await client.generations.wait(task.data.id)
print(result.data.result?.videos?.first?.url.absoluteString ?? "")

Dart / Flutter

final task = await client.generations.create(
  CreateGenerationRequest(
    model: 'kling/kling-v3',
    mode: 'text_to_video',
    prompt: 'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
  ).withParam('duration', '5s').withParam('resolution', 'std').withParam('aspect_ratio', '16:9').withParam('audio', 'false'),
);

final result = await client.generations.wait(task.data.id);
print(result.data.result?.videos.firstOrNull?.url);

Elixir

{:ok, task} =
  Buble.Generations.create(client, %{
    model: "kling/kling-v3",
    mode: "text_to_video",
    prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    duration: "5s",
    resolution: "std",
    aspect_ratio: "16:9",
    audio: "false"
  })

{:ok, result} = Buble.Generations.wait(client, task["data"]["id"])
IO.puts(result["data"]["result"]["videos"] |> List.first() |> Map.fetch!("url"))

Java

Envelope<GenerationTask> task = client.generations().create(
        CreateGenerationRequest.builder()
                .model("kling/kling-v3")
                .mode("text_to_video")
                .prompt("A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion")
                .param("duration", "5s")
                .param("resolution", "std")
                .param("aspect_ratio", "16:9")
                .param("audio", "false")
                .build());

Envelope<GenerationTask> result = client.generations().wait(task.getData().getId());

.NET

var task = await client.Generations.CreateAsync(new CreateGenerationRequest
{
    Model = "kling/kling-v3",
    Mode = "text_to_video",
    Prompt = "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion"
}.WithParam("duration", "5s").WithParam("resolution", "std").WithParam("aspect_ratio", "16:9").WithParam("audio", "false"));

var result = await client.Generations.WaitAsync(task!.Data!.Id!);

PHP

$task = $client->generations()->create(
    CreateGenerationRequest::make(
        model: 'kling/kling-v3',
        mode: 'text_to_video',
        prompt: 'A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion',
    )
    ->withParam('duration', '5s')
    ->withParam('resolution', 'std')
    ->withParam('aspect_ratio', '16:9')
    ->withParam('audio', 'false')
);

$result = $client->generations()->wait($task['data']['id']);

Ruby

task = client.generations.create(
  model: "kling/kling-v3",
  mode: "text_to_video",
  prompt: "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
  duration: "5s",
  resolution: "std",
  aspect_ratio: "16:9",
  audio: "false"
)

result = client.generations.wait(task.dig("data", "id"))
puts result.dig("data", "result", "videos", 0, "url")