curl https://api.nunchux.ai/v1/klingai/videos/text2video \
  -H "X-API-Key: $NUNCHUX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: YourApp/1.0" \
  -d '{
    "model_name": "kling-v3",
    "prompt": "a paper crane unfolding into a real bird, cinematic slow motion",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

import os, requests

resp = requests.post(
    "https://api.nunchux.ai/v1/klingai/videos/text2video",
    headers={"X-API-Key": os.environ["NUNCHUX_API_KEY"], "User-Agent": "YourApp/1.0"},
    json={
        "model_name": "kling-v3",
        "prompt": "a paper crane unfolding into a real bird, cinematic slow motion",
        "mode": "std",
        "duration": "5",
        "aspect_ratio": "16:9",
    },
)
task_id = resp.json()["data"]["task_id"]

const submit = await fetch("https://api.nunchux.ai/v1/klingai/videos/text2video", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.NUNCHUX_API_KEY,
    "Content-Type": "application/json",
    "User-Agent": "YourApp/1.0",
  },
  body: JSON.stringify({
    model_name: "kling-v3",
    prompt: "a paper crane unfolding into a real bird, cinematic slow motion",
    mode: "std",
    duration: "5",
    aspect_ratio: "16:9",
  }),
}).then((r) => r.json());
const taskId = submit.data.task_id;

IMG_B64=$(base64 < input.jpg | tr -d '\n')

curl https://api.nunchux.ai/v1/klingai/videos/image2video \
  -H "X-API-Key: $NUNCHUX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: YourApp/1.0" \
  -d "{
    \"model_name\": \"kling-v3\",
    \"prompt\": \"camera pushes in slowly, subtle ambient motion\",
    \"mode\": \"pro\",
    \"duration\": \"5\",
    \"image\": \"$IMG_B64\"
  }"

import base64, os, requests

with open("input.jpg", "rb") as f:
    img_b64 = base64.b64encode(f.read()).decode()

resp = requests.post(
    "https://api.nunchux.ai/v1/klingai/videos/image2video",
    headers={"X-API-Key": os.environ["NUNCHUX_API_KEY"], "User-Agent": "YourApp/1.0"},
    json={
        "model_name": "kling-v3",
        "prompt": "camera pushes in slowly, subtle ambient motion",
        "mode": "pro",
        "duration": "5",
        "image": img_b64,
    },
)
task_id = resp.json()["data"]["task_id"]

import { readFile } from "node:fs/promises";

const imgB64 = (await readFile("input.jpg")).toString("base64");

const submit = await fetch("https://api.nunchux.ai/v1/klingai/videos/image2video", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.NUNCHUX_API_KEY,
    "Content-Type": "application/json",
    "User-Agent": "YourApp/1.0",
  },
  body: JSON.stringify({
    model_name: "kling-v3",
    prompt: "camera pushes in slowly, subtle ambient motion",
    mode: "pro",
    duration: "5",
    image: imgB64,
  }),
}).then((r) => r.json());
const taskId = submit.data.task_id;

# Placeholder URL: point it at your own publicly reachable file.
curl https://api.nunchux.ai/v1/klingai/videos/omni-video \
  -H "X-API-Key: $NUNCHUX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: YourApp/1.0" \
  -d '{
    "model_name": "kling-v3-omni",
    "prompt": "<<<image_1>>> walks through a neon-lit market, cinematic",
    "mode": "std",
    "duration": "5",
    "image_list": [{ "image_url": "https://example.com/example.jpg" }]
  }'

# Placeholder URL: point it at your own publicly reachable file.
import os, requests

resp = requests.post(
    "https://api.nunchux.ai/v1/klingai/videos/omni-video",
    headers={"X-API-Key": os.environ["NUNCHUX_API_KEY"], "User-Agent": "YourApp/1.0"},
    json={
        "model_name": "kling-v3-omni",
        "prompt": "<<<image_1>>> walks through a neon-lit market, cinematic",
        "mode": "std",
        "duration": "5",
        "image_list": [{"image_url": "https://example.com/example.jpg"}],
    },
)
task_id = resp.json()["data"]["task_id"]

// Placeholder URL: point it at your own publicly reachable file.
const submit = await fetch("https://api.nunchux.ai/v1/klingai/videos/omni-video", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.NUNCHUX_API_KEY,
    "Content-Type": "application/json",
    "User-Agent": "YourApp/1.0",
  },
  body: JSON.stringify({
    model_name: "kling-v3-omni",
    prompt: "<<<image_1>>> walks through a neon-lit market, cinematic",
    mode: "std",
    duration: "5",
    image_list: [{ image_url: "https://example.com/example.jpg" }],
  }),
}).then((r) => r.json());
const taskId = submit.data.task_id;

# Placeholder URLs: point them at your own publicly reachable files.
curl https://api.nunchux.ai/v1/klingai/videos/motion-control \
  -H "X-API-Key: $NUNCHUX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: YourApp/1.0" \
  -d '{
    "model_name": "kling-v3",
    "mode": "std",
    "image_url": "https://example.com/example.jpg",
    "video_url": "https://example.com/example.mp4",
    "character_orientation": "image",
    "input_video_seconds": 5
  }'

# Placeholder URLs: point them at your own publicly reachable files.
import os, requests

resp = requests.post(
    "https://api.nunchux.ai/v1/klingai/videos/motion-control",
    headers={"X-API-Key": os.environ["NUNCHUX_API_KEY"], "User-Agent": "YourApp/1.0"},
    json={
        "model_name": "kling-v3",
        "mode": "std",
        "image_url": "https://example.com/example.jpg",
        "video_url": "https://example.com/example.mp4",
        "character_orientation": "image",
        "input_video_seconds": 5,
    },
)
task_id = resp.json()["data"]["task_id"]

// Placeholder URLs: point them at your own publicly reachable files.
const submit = await fetch("https://api.nunchux.ai/v1/klingai/videos/motion-control", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.NUNCHUX_API_KEY,
    "Content-Type": "application/json",
    "User-Agent": "YourApp/1.0",
  },
  body: JSON.stringify({
    model_name: "kling-v3",
    mode: "std",
    image_url: "https://example.com/example.jpg",
    video_url: "https://example.com/example.mp4",
    character_orientation: "image",
    input_video_seconds: 5,
  }),
}).then((r) => r.json());
const taskId = submit.data.task_id;

# 1. Submit
SUBMIT=$(curl -sS --fail-with-body https://api.nunchux.ai/v1/klingai/videos/text2video \
  -H "X-API-Key: $NUNCHUX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: YourApp/1.0" \
  -d '{
    "model_name": "kling-v3",
    "prompt": "A cinematic drone shot sweeping over snow-capped mountains at sunrise",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }') || { echo "submit failed: $SUBMIT" >&2; exit 1; }
TASK=$(jq -er '.data.task_id' <<<"$SUBMIT") || { echo "no task id in: $SUBMIT" >&2; exit 1; }

# 2. Poll until the task reaches a terminal status
DELAY=5
TERMINAL=0
for _ in $(seq 1 90); do
  RESP=$(curl -sS https://api.nunchux.ai/v1/klingai/videos/text2video/$TASK \
    -H "X-API-Key: $NUNCHUX_API_KEY" \
    -H "User-Agent: YourApp/1.0")
  STATUS=$(jq -r '.data.task_status' <<<"$RESP")
  case "$STATUS" in succeed|failed) TERMINAL=1; break ;; esac
  sleep "$DELAY"; DELAY=$(( DELAY * 2 > 30 ? 30 : DELAY * 2 ))
done
[ "$TERMINAL" = 1 ] || { echo "timed out (last status: $STATUS)" >&2; exit 1; }

# 3. Check for failure
[ "$STATUS" = "succeed" ] || { echo "Kling: status $STATUS, not succeed: $(jq -c '.data.task_status_msg // empty' <<<"$RESP")" >&2; exit 1; }

# 4. Download
curl -sSL -o kling.mp4 "$(jq -r '.data.task_result.videos[0].url' <<<"$RESP")"

import os, time, requests

BASE = "https://api.nunchux.ai"
HEADERS = {
    "X-API-Key": os.environ["NUNCHUX_API_KEY"],
    "Content-Type": "application/json",
    "User-Agent": "YourApp/1.0",
}

# 1. Submit
submit = requests.post(
    f"{BASE}/v1/klingai/videos/text2video",
    headers=HEADERS,
    json={
        "model_name": "kling-v3",
        "prompt": "A cinematic drone shot sweeping over snow-capped mountains at sunrise",
        "mode": "std",
        "duration": "5",
        "aspect_ratio": "16:9",
    },
)
if not submit.ok:
    raise RuntimeError(f"submit failed: HTTP {submit.status_code} {submit.text}")
task_id = submit.json()["data"]["task_id"]

# 2. Poll until the task reaches a terminal status
TERMINAL = ("succeed", "failed")
delay = 5
for _ in range(90):
    task = requests.get(f"{BASE}/v1/klingai/videos/text2video/{task_id}", headers=HEADERS).json()
    if task["data"]["task_status"] in TERMINAL:
        break
    time.sleep(delay)
    delay = min(delay * 2, 30)
else:
    raise TimeoutError("Kling task did not finish")

# 3. Check for failure
if task["data"]["task_status"] != "succeed":
    raise RuntimeError(f"Kling: status {task['data']['task_status']}, not succeed: {task['data'].get('task_status_msg')}")

# 4. Download
with requests.get(task["data"]["task_result"]["videos"][0]["url"], stream=True, timeout=300) as r:
    r.raise_for_status()
    with open("kling.mp4", "wb") as f:
        for chunk in r.iter_content(1 << 14):
            f.write(chunk)

import { writeFile } from "node:fs/promises";

const BASE = "https://api.nunchux.ai";
const HEADERS = {
  "X-API-Key": process.env.NUNCHUX_API_KEY,
  "Content-Type": "application/json",
  "User-Agent": "YourApp/1.0",
};
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

// 1. Submit
const submitRes = await fetch(`${BASE}/v1/klingai/videos/text2video`, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    model_name: "kling-v3",
    prompt: "A cinematic drone shot sweeping over snow-capped mountains at sunrise",
    mode: "std",
    duration: "5",
    aspect_ratio: "16:9",
  }),
});
if (!submitRes.ok) throw new Error(`submit failed: HTTP ${submitRes.status} ${await submitRes.text()}`);
const taskId = (await submitRes.json()).data.task_id;

// 2. Poll until the task reaches a terminal status
const TERMINAL = ["succeed", "failed"];
let task;
let delay = 5_000;
for (let i = 0; i < 90; i++) {
  task = await fetch(`${BASE}/v1/klingai/videos/text2video/${taskId}`, { headers: HEADERS }).then((r) =>
    r.json()
  );
  if (TERMINAL.includes(task?.data?.task_status)) break;
  await sleep(delay);
  delay = Math.min(delay * 2, 30_000);
}
if (!TERMINAL.includes(task?.data?.task_status)) throw new Error("Kling task did not finish");

// 3. Check for failure
if (task.data.task_status !== "succeed") {
  throw new Error(`Kling: status ${task.data.task_status}, not succeed: ${JSON.stringify(task.data.task_status_msg)}`);
}

// 4. Download
const res = await fetch(task.data.task_result.videos[0].url);
if (!res.ok) throw new Error(`download failed: HTTP ${res.status}`);
await writeFile("kling.mp4", Buffer.from(await res.arrayBuffer()));