Appearance
Kling
Kling video models for expressive motion, subject control, and creative clips.
API surface
| Operation | Endpoint | Mode |
|---|---|---|
| Video generation task | POST /v1/async/videos/generations | Async only |
Models
| Model id | Notes |
|---|---|
kling-3.0-turbo | Text-to-video and image-to-video (first frame only). seconds 3–15. |
kling-v3 | Text-to-video and image-to-video. seconds 3–15. |
kling-v3-omni | Same rates as kling-v3, with richer providerOptions (video_list, metadata.image_list, etc.). |
Pricing
Billed as n × seconds × rate(resolution) credits. Default resolution is 720p.
| Model | 720p | 1080p |
|---|---|---|
kling-3.0-turbo | 6/sec | 8/sec |
kling-v3 / kling-v3-omni | 9/sec | 12/sec |
Top-level resolution maps to upstream mode=std|pro.
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | kling-3.0-turbo, kling-v3, or kling-v3-omni. |
prompt | string | Yes | 1–2000 characters. |
seconds | integer | Yes | 3–15. |
resolution | string | No | 720p (default) or 1080p. |
n | integer | No | Default 1. |
image | string | string[] | No | Public http(s) image URL for image-to-video. |
providerOptions | object | No | Optional model extensions. See providerOptions below. |
providerOptions
| Field | Type | Models | Description |
|---|---|---|---|
aspect_ratio | string | all | 16:9 / 9:16 / 1:1. |
audio | boolean | kling-v3, kling-v3-omni | Whether to generate native audio. |
image_with_roles | object[] | kling-v3 | Role-tagged reference images. |
reference_images | array | kling-v3, kling-3.0-turbo | Extra reference images. |
negative_prompt | string | kling-v3 | Content to avoid. |
watermark | boolean | all | Whether to add a watermark. |
video_list | array | kling-v3-omni | Omni video reference list. |
metadata | object | kling-v3, kling-v3-omni | Passthrough fields (for example Omni image_list). Pixapi does not interpret them. |
Top-level resolution maps to upstream mode=std|pro (720p → std, 1080p → pro).
Example
bash
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0-turbo",
"prompt": "A product spin on a clean studio turntable",
"n": 1,
"seconds": 5,
"resolution": "720p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}'py
import os
import requests
response = requests.post(
"https://api.pixapi.ai/v1/async/videos/generations",
headers={
"Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "kling-3.0-turbo",
"prompt": "A product spin on a clean studio turntable",
"n": 1,
"seconds": 5,
"resolution": "720p",
"providerOptions": {
"aspect_ratio": "16:9"
}
},
)
response.raise_for_status()
task = response.json()
print(task["id"])js
const response = await fetch('https://api.pixapi.ai/v1/async/videos/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "kling-3.0-turbo",
"prompt": "A product spin on a clean studio turntable",
"n": 1,
"seconds": 5,
"resolution": "720p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}),
});
if (!response.ok) {
throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"model": "kling-3.0-turbo",
"prompt": "A product spin on a clean studio turntable",
"n": 1,
"seconds": 5,
"resolution": "720p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}`)
req, err := http.NewRequest(
"POST",
"https://api.pixapi.ai/v1/async/videos/generations",
bytes.NewBuffer(body),
)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}Response
Pixapi returns a submitted task. Poll GET /v1/tasks/{id} for the final result.
