Kling 2.5 Turbo Text-to-Video

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model ID	kling-2.5-turbo/text-to-video
Type	Video generation (text-to-video)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

Generate 5- or 10-second video from text in landscape, portrait or square, with an included audio track.

Production guidance

For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
Use callback.when=final. Both success and fail are terminal states, so your service should deduplicate by taskId.

Best suited for

Written scene ideas

Describe action and environments without an image.

prompt

Landscape, portrait and square

Frame the scene for its destination.

aspect_ratio

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value kling-2.5-turbo/text-to-video.

example kling-2.5-turbo/text-to-video

input object required

Video generation settings.

prompt string required

Describe the subject, action, setting and camera movement in 1–2500 characters.

duration enum optional

Length of the generated video in seconds.

default 5 enum: 510

aspect_ratio enum optional

Choose landscape, portrait or square framing.

default 16:9 enum: 16:99:161:1

negative_prompt string optional

Describe unwanted content, up to 2500 characters.

cfg_scale number optional

Adjust prompt adherence from 0 to 1.

default 0.5

callback object optional

Optional callback configuration. When set, HiAPI notifies your service when the task reaches a terminal state.

url string required

Required when callback is set; HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Camper van at sunrise

Describe lakeside mist and a low camera glide.

Request body

{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

Getting the result

The response returns a taskId immediately without waiting for generation to finish.
In production, prefer waiting for callback.url to receive the terminal notification. For local debugging, poll GET /v1/tasks/:id.
When status=success, download the generated video from output[].url.
When status=fail, fix the request based on the returned error instead of retrying the same invalid payload.

FAQ

Can I change the resolution?

There is no resolution selector. Output is 1440×1440 for 1:1, 1920×1080 for 16:9 and 1080×1920 for 9:16.

Does the video have sound?

An audio track is included, with no audio switch. Listen and edit if dialogue or music must meet specific requirements.