API Reference

Kling Text-to-Video

Create a text-to-video task and follow it through completion or failure.

Overview

Create an asynchronous text-to-video task with a supported model. Use the returned task ID to retrieve its state, or provide callback_url for terminal delivery.

Quick start

Create an API key and set it as RUNAPI_API_KEY.
Choose a supported model and send a POST request whose body matches that model's schema.
Store the returned task ID, then poll until a terminal state or handle the terminal callback.

POST /api/v1/kling/text_to_video

Base URL: https://runapi.ai
API version: v1
Authentication: Authorization: Bearer YOUR_API_TOKEN

Supported models

Open a model page for current pricing, rate limits, and commercial-usage details.

Request schema

JSON body

Fields and allowed values depend on the selected model. When supplied, callback_url receives a terminal task delivery.

kling-3.014 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1

callback_urlstring

Optional

Webhook URL for async notifications.

cfg_scalenumber

Optional

Guidance scale (0-1).

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

enable_soundboolean

Optional

Enable sound generation.

first_frame_image_urlstring

Optional

First frame image URL.

kling_elementsarray

Optional

Element references with image, video, or audio materials.

last_frame_image_urlstring

Optional

Last frame image URL for single-shot mode.

modelstring

Required

Model slug.

multi_promptarray

Optional

Prompt segments for multi-shot mode.

multi_shotsboolean

Optional

Enable multi-shot generation.

negative_promptstring

Optional

Negative prompt.

output_resolutionstring

Optional

Output resolution.

Allowed values: 720p, 1080p, 4k

promptstring

Optional

Video description. Required unless multi_shots is enabled.

kling-o111 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1 Default: 16:9

callback_urlstring

Optional

Webhook URL for async notifications.

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 5 Default: 5

enable_soundboolean

Optional

Sound generation must remain disabled.

Default: false

modestring

Optional

Generation mode.

Allowed values: std, pro Default: std

modelstring

Required

Model slug.

preserve_reference_video_audioboolean

Optional

Preserve the reference video's original audio.

Default: false

promptstring

Required

Video description; reference media with matching numbered markers.

Range: 1 - 2500

reference_image_urlsarray

Optional

Ordered public HTTP(S) JPG, JPEG, or PNG reference image URLs.

reference_video_typestring

Optional

Use the video as a base edit or feature reference.

Allowed values: base, feature Default: base

reference_video_urlstring

Optional

Public HTTP(S) MP4 or MOV reference video URL.

kling-v2.1-master-text-to-video8 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1

callback_urlstring

Optional

Webhook URL for async notifications.

cfg_scalenumber

Optional

Guidance scale (0-1).

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 5, 10

enable_soundboolean

Optional

Enable sound generation.

modelstring

Required

Model slug.

negative_promptstring

Optional

Negative prompt.

promptstring

Optional

Video description.

kling-v2.5-turbo-text-to-video-pro8 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1

callback_urlstring

Optional

Webhook URL for async notifications.

cfg_scalenumber

Optional

Guidance scale (0-1).

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 5, 10

enable_soundboolean

Optional

Enable sound generation.

modelstring

Required

Model slug.

negative_promptstring

Optional

Negative prompt.

promptstring

Optional

Video description.

kling-v2.67 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1 Default: 16:9

callback_urlstring

Optional

Webhook URL for async notifications.

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 5, 10 Default: 5

enable_soundboolean

Optional

Enable sound generation; requires pro mode.

Default: false

modestring

Optional

Generation mode.

Allowed values: std, pro Default: std

modelstring

Required

Model slug.

promptstring

Required

Video description.

Range: 1 - 2500

kling-v3-omni7 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1 Default: 16:9

callback_urlstring

Optional

Webhook URL for async notifications.

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Default: 5

enable_soundboolean

Optional

Enable synchronized sound generation.

Default: false

modelstring

Required

Model slug.

output_resolutionstring

Optional

Output resolution.

Allowed values: 720p, 1080p, 4k Default: 720p

promptstring

Required

Video description.

Range: 1 - 2500

kling-v3-turbo-text-to-video6 fields

aspect_ratiostring

Optional

Output aspect ratio.

Allowed values: 16:9, 9:16, 1:1 Default: 16:9

callback_urlstring

Optional

Webhook URL for async notifications.

duration_secondsinteger

Optional

Duration in seconds.

Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Default: 5

modelstring

Required

Model slug.

output_resolutionstring

Optional

Output resolution.

Allowed values: 720p, 1080p Default: 720p

promptstring

Required

Video description.

Range: 1 - 2500

Create acceptance

HTTP 202

POST /api/v1/kling/text_to_video

JSON

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

Polling processing

HTTP 200

GET /api/v1/kling/text_to_video/:id

JSON

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

Polling completed

HTTP 200

GET /api/v1/kling/text_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"
    }
  ]
}

Polling failed

HTTP 200

GET /api/v1/kling/text_to_video/:id

JSON

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

Customer callback: completed

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"
    }
  ]
}

Customer callback: failed

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"
}

Errors

HTTP 400

JSON

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

Generated Code Samples

Use cURL directly, or install an SDK for your language. Each sample submits the validated request shown in this reference.

CURL

curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"kling-v3-turbo-text-to-video","prompt":"A paper kite flying above a quiet coastal town at sunrise","duration_seconds":5,"aspect_ratio":"16:9","output_resolution":"720p"}'

Install

BASH

npm install @runapi.ai/kling

JAVASCRIPT

import { KlingClient } from "@runapi.ai/kling";

const client = new KlingClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.textToVideo.create({
  "model": "kling-v3-turbo-text-to-video",
  "prompt": "A paper kite flying above a quiet coastal town at sunrise",
  "duration_seconds": 5,
  "aspect_ratio": "16:9",
  "output_resolution": "720p"
});

Install

BASH

pip install runapi-kling

PYTHON

import os
from runapi.kling import KlingClient

client = KlingClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.text_to_video.create(
  model="kling-v3-turbo-text-to-video",
  prompt="A paper kite flying above a quiet coastal town at sunrise",
  duration_seconds=5,
  aspect_ratio="16:9",
  output_resolution="720p"
)

Install

BASH

go get github.com/runapi-ai/kling-sdk/go@latest

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  kling "github.com/runapi-ai/kling-sdk/go/kling"
)

func main() {
  client, err := kling.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  _, err = client.TextToVideo.Create(context.Background(), kling.TextToVideoParams{
    Model: "kling-v3-turbo-text-to-video",
    Prompt: "A paper kite flying above a quiet coastal town at sunrise",
    DurationSeconds: 5,
    AspectRatio: "16:9",
    OutputResolution: "720p",
  })
  if err != nil {
    log.Fatal(err)
  }
}

Install

BASH

gem install runapi-kling

RUBY

client = RunApi::Kling::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY"))
task = client.text_to_video.create(
  model: "kling-v3-turbo-text-to-video",
  prompt: "A paper kite flying above a quiet coastal town at sunrise",
  duration_seconds: 5,
  aspect_ratio: "16:9",
  output_resolution: "720p"
)

Install

KOTLIN

implementation("ai.runapi:runapi-kling")

JAVA

import ai.runapi.core.polling.TaskCreateResponse;
import ai.runapi.kling.KlingClient;
import ai.runapi.kling.types.TextToVideoParams;

KlingClient client = KlingClient.builder()
    .apiKey(System.getenv("RUNAPI_API_KEY"))
    .build();
TaskCreateResponse task = client.textToVideo().create(
    TextToVideoParams.builder()
        .model("kling-v3-turbo-text-to-video")
        .prompt("A paper kite flying above a quiet coastal town at sunrise")
        .durationSeconds(5)
        .aspectRatio("16:9")
        .outputResolution("720p")
        .build()
);

Install

BASH

composer require runapi-ai/kling

PHP

<?php

use RunApi\Core\ClientOptions;
use RunApi\Kling\KlingClient;

$client = new KlingClient(new ClientOptions(apiKey: getenv('RUNAPI_API_KEY')));
$task = $client->textToVideo->create([
  "model" => "kling-v3-turbo-text-to-video",
  "prompt" => "A paper kite flying above a quiet coastal town at sunrise",
  "duration_seconds" => 5,
  "aspect_ratio" => "16:9",
  "output_resolution" => "720p"
]);

Related Guides

curl -X POST https://runapi.ai/api/v1/kling/text_to_video \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"model":"kling-v3-turbo-text-to-video","prompt":"A paper kite flying above a quiet coastal town at sunrise","duration_seconds":5,"aspect_ratio":"16:9","output_resolution":"720p"}'

import { KlingClient } from "@runapi.ai/kling"; const client = new KlingClient({ apiKey: process.env.RUNAPI_API_KEY }); const task = await client.textToVideo.create({ "model": "kling-v3-turbo-text-to-video", "prompt": "A paper kite flying above a quiet coastal town at sunrise", "duration_seconds": 5, "aspect_ratio": "16:9", "output_resolution": "720p" });

import os from runapi.kling import KlingClient client = KlingClient(api_key=os.environ["RUNAPI_API_KEY"]) task = client.text_to_video.create( model="kling-v3-turbo-text-to-video", prompt="A paper kite flying above a quiet coastal town at sunrise", duration_seconds=5, aspect_ratio="16:9", output_resolution="720p" )

package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" kling "github.com/runapi-ai/kling-sdk/go/kling" ) func main() { client, err := kling.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } _, err = client.TextToVideo.Create(context.Background(), kling.TextToVideoParams{ Model: "kling-v3-turbo-text-to-video", Prompt: "A paper kite flying above a quiet coastal town at sunrise", DurationSeconds: 5, AspectRatio: "16:9", OutputResolution: "720p", }) if err != nil { log.Fatal(err) } }

client = RunApi::Kling::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY")) task = client.text_to_video.create( model: "kling-v3-turbo-text-to-video", prompt: "A paper kite flying above a quiet coastal town at sunrise", duration_seconds: 5, aspect_ratio: "16:9", output_resolution: "720p" )

import ai.runapi.core.polling.TaskCreateResponse; import ai.runapi.kling.KlingClient; import ai.runapi.kling.types.TextToVideoParams; KlingClient client = KlingClient.builder() .apiKey(System.getenv("RUNAPI_API_KEY")) .build(); TaskCreateResponse task = client.textToVideo().create( TextToVideoParams.builder() .model("kling-v3-turbo-text-to-video") .prompt("A paper kite flying above a quiet coastal town at sunrise") .durationSeconds(5) .aspectRatio("16:9") .outputResolution("720p") .build() );

<?php use RunApi\Core\ClientOptions; use RunApi\Kling\KlingClient; $client = new KlingClient(new ClientOptions(apiKey: getenv('RUNAPI_API_KEY'))); $task = $client->textToVideo->create([ "model" => "kling-v3-turbo-text-to-video", "prompt" => "A paper kite flying above a quiet coastal town at sunrise", "duration_seconds" => 5, "aspect_ratio" => "16:9", "output_resolution" => "720p" ]);

Kling Text-to-Video

Overview

Quick start

Endpoint

Supported models

Request schema

Create acceptance

Polling processing

Polling completed

Polling failed

Customer callback: completed

Customer callback: failed

Errors

Generated Code Samples

Install

Install

Install

Install

Install

Install

Related Guides