Kling 3.0 Turbo Text to Video API

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

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

Model summary

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

Kling 3.0 Turbo text-to-video: the speed tier of the 3.0 family — 3-15s, 720p/1080p, per-second tiered billing, built for volume.

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

Cost-efficient volume

The fast tier of the 3.0 family: low per-second price and quick turnaround.

promptresolution

Flexible 3-15s

From snappy social clips to 15-second stories, billed per second.

duration

Lip-synced dialogue

Quoted lines in the prompt are lip-synced for light narrative clips.

prompt

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-3.0-turbo/text-to-video",
  "input": {
    "prompt": "A fluffy corgi puppy sprinting across a sunlit meadow in slow motion, ears flapping, golden hour backlight, cinematic tracking shot, shallow depth of field",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "kling-3.0-turbo/text-to-video",
  "input": {
    "prompt": "A fluffy corgi puppy sprinting across a sunlit meadow in slow motion, ears flapping, golden hour backlight, cinematic tracking shot, shallow depth of field",
    "duration": 5,
    "resolution": "720p",
    "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-3.0-turbo/text-to-video",
  "input": {
    "prompt": "A fluffy corgi puppy sprinting across a sunlit meadow in slow motion, ears flapping, golden hour backlight, cinematic tracking shot, shallow depth of field",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

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

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

input object required

Business parameters. Put Kling 3.0 Turbo Text to Video-specific configuration here.

prompt string required

Text description of the video to generate. Max 2500 characters. Supports dialogue lines in quotes for lip-synced speech.

duration integer optional

Duration of the generated video in seconds (3-15).

default 5

resolution enum optional

Resolution of the generated video.

default 720p enum: 720p1080p

aspect_ratio enum optional

Aspect ratio of the generated video frame.

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

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

Sunset corgi (defaults)

Tested with a prompt-only minimal call, 720p 5s.

Request body

{
  "model": "kling-3.0-turbo/text-to-video",
  "input": {
    "prompt": "A fluffy corgi puppy sprinting across a sunlit meadow in slow motion, ears flapping, golden hour backlight, cinematic tracking shot, shallow depth of field",
    "duration": 5,
    "resolution": "720p",
    "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

Turbo vs kling-3.0-omni?

Turbo is the faster, lower-cost 720p/1080p tier and its current HiAPI request contract has no separate sound switch. Omni adds 4K, an audio control, and broader shot controls. Use Turbo for frequent iteration and Omni when the final workflow needs those higher-end controls.

How is it billed?

Per second, tiered by resolution (720p/1080p), 3-15s duration.