Kling Video · v3 · Pro · Motion Control

ผสานการทำงาน

ID โมเดล kling-video/v3/pro/motion-control

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/kling-video/v3/pro/motion-control?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/kling-video/v3/pro/motion-control", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/th/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "kling-video/v3/pro/motion-control",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }
}

เรียกใช้โมเดล Kling Video · v3 · Pro · Motion Control (kling-video/v3/pro/motion-control) ผ่าน Doitong API เอกสารสำหรับเอเจนต์: https://doitong.com/th/developers/models/kling-video/v3/pro/motion-control.md

POST https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
  "character_orientation": "image"
}

หากสถานะการตอบกลับเป็น "queued" หรือ "running" ให้ส่งคำขอแบบสำรวจ GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 จนกว่าจะเป็น "succeeded" ไฟล์อยู่ใน outputs[].url การส่ง POST https://api.doitong.com/v1/quote/kling-video/v3/pro/motion-control ด้วยบอดี้เดียวกันจะแสดงราคาที่แน่นอนก่อนเรียกใช้

ไฟล์เช่นเดียวกับตัวอย่าง: $1.68 1,680 เครดิต API ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API

Kling วิดีโอเป็นวิดีโอ อินพุตอ้างอิง #stylized#transform#editing

การถ่ายโอนการเคลื่อนไหวระดับ Pro ที่นำการเคลื่อนไหวของตัวละครจากวิดีโออ้างอิงไปใช้กับภาพตัวละคร

OpenAPI Markdown

Kling · วิดีโอ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ราคาต่อวินาทีของวิดีโออินพุต

คิดราคาตามอินพุตของคุณ

$0.168 / วินาทีของวิดีโออินพุต

168 เครดิต API / วินาทีของวิดีโออินพุต

คำขอนี้: 10 วินาที × $0.168 $1.68 1,680 เครดิต API

เรียกใช้ · $1.68

เรียกเก็บเงินเมื่อสำเร็จเท่านั้น และคืนเงินอัตโนมัติเมื่อไม่สำเร็จ

ไฟล์อินพุตของคุณ

video_url

ความยาว, s

เครื่องคำนวณใช้ตัวเลขเหล่านี้ POST /quote/kling-video/v3/pro/motion-control จะวัดไฟล์จริงของคุณและแสดงราคาที่แน่นอน

ไฟล์ของคุณจะถูกวัดก่อนการรัน (ความยาว ความละเอียด อัตราเฟรม); ใบเสนอราคาจะแสดงราคาที่แน่นอน และการรันจะเรียกเก็บเงินตามนั้นพอดี

เอนด์พอยต์ใบเสนอราคา: POST /quote/{id}

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

prompt 0 / 2500

image •จำเป็น image_url

วางไฟล์ หรือ

URL ของรูปภาพอ้างอิงสำหรับการสร้างวิดีโอ โดยขนาดไฟล์ต้องไม่เกิน 10.0MB ความกว้างและความสูงต้องอยู่ระหว่าง 340px ถึง 3850px และอัตราส่วนภาพต้องอยู่ระหว่าง 0.40 ถึง 2.50 รูปภาพนี้ใช้กำหนดตัวละคร ฉากหลัง และองค์ประกอบอื่น ๆ ของวิดีโอ สำหรับตัวละคร ต้องเห็นสัดส่วนร่างกายอย่างชัดเจน ไม่มีสิ่งบดบัง และมีพื้นที่ครอบคลุมมากกว่า 5% ของรูปภาพ

video •จำเป็น video_url

วางไฟล์ หรือ

URL ที่ชี้ไปยังวิดีโอซึ่งใช้กำหนดการเคลื่อนไหวของตัวละครในเอาต์พุต ควรแสดงตัวละครสไตล์สมจริงที่ไม่มีสิ่งบดบัง โดยมองเห็นศีรษะและทั้งร่างกายหรือร่างกายส่วนบน การตั้งค่า character_orientation จำกัดระยะเวลาไว้ที่ 10s สำหรับ 'image' หรือ 30s สำหรับ 'video' ข้อจำกัดไฟล์: ขนาดไม่เกิน 100 MB ความกว้างและความสูงอยู่ระหว่าง 340px ถึง 3850px และระยะเวลาอยู่ระหว่าง 3.0s ถึง 30.05s

character_orientation •จำเป็น

แหล่งที่มาของการวางแนวตัวละคร: 'image' จะตรงกับรูปภาพอ้างอิงและเหมาะกับการติดตามการเคลื่อนกล้องมากกว่า โดยมีระยะเวลาสูงสุด 10 วินาที สำหรับการเคลื่อนไหวที่ซับซ้อน ให้ใช้ 'video' ซึ่งจะตรงกับการวางแนวของวิดีโออ้างอิงและรองรับระยะเวลาสูงสุด 30 วินาที

ขั้นสูง enable_safety_checker · keep_original_sound · elements

elements

การผูกองค์ประกอบใบหน้าเสริมเพื่อช่วยรักษาอัตลักษณ์ในเอาต์พุตวิดีโอ โดยอัปโหลดองค์ประกอบได้ไม่เกิน 1 รายการ ใช้ @Element1 เพื่ออ้างอิงในพรอมต์ การผูกนี้ใช้ได้เฉพาะเมื่อ character_orientation ตั้งเป็น 'video'

POST /run/kling-video/v3/pro/motion-control?wait=20 ใบเสนอราคา → $1.68

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/kling-video/v3/pro/motion-control?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/kling-video/v3/pro/motion-control?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/kling-video/v3/pro/motion-control", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "kling-video/v3/pro/motion-control",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
        "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
        "character_orientation": "image"
      },
      "wait_seconds": 20
    }
  }
}

เรียกใช้คำขอนี้

คีย์ API

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง Doitong API เท่านั้น และจะบันทึกใน localStorage ก็ต่อเมื่อคุณเลือกจดจำ จดจำในเบราว์เซอร์นี้ รับคีย์ API

เกี่ยวกับ Kling Video · v3 · Pro · Motion Control

ผสานภาพตัวละครใน `image_url` เข้ากับการเคลื่อนไหวจากวิดีโออ้างอิงใน `video_url` ต้องระบุ `character_orientation` เพื่อเลือกว่าทิศทางจะอ้างอิงภาพหรือวิดีโอ รองรับ `prompt` ที่เป็นตัวเลือกเสริมและมีความยาวไม่เกิน 2500 อักขระ `keep_original_sound` จะเก็บเสียงอ้างอิงไว้ และสามารถผูกองค์ประกอบใบหน้าได้หนึ่งรายการผ่าน `elements` เพื่อช่วยรักษาอัตลักษณ์

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย

enable_safety_checkerไม่บังคับ

ประเภทboolean

ค่าเริ่มต้นtrue

ปิดใช้การตรวจสอบความปลอดภัยได้เฉพาะเมื่อบัญชีได้รับอนุญาต คำขอที่ไม่มีการอนุญาตจะผ่านการตรวจสอบเสมอ

promptไม่บังคับ

ประเภทstring | null

≤ 2,500 อักขระ

image_urlจำเป็น image

ประเภทurl · image

video_urlจำเป็น video

ประเภทurl · video

keep_original_soundไม่บังคับ

ประเภทboolean

ค่าเริ่มต้นtrue

ควบคุมการคงเสียงต้นฉบับของวิดีโออ้างอิง

character_orientationจำเป็น

ประเภทenum

imagevideo

elementsไม่บังคับ

ประเภทobject[]

elements[].frontal_image_urlไม่บังคับ

ประเภทurl · image

รูปภาพมุมมองด้านหน้าที่แสดงมุมหลักขององค์ประกอบ ขนาดไฟล์ต้องไม่เกิน 50 MB ความกว้างและความสูงต้องไม่น้อยกว่า 300px และอัตราส่วนภาพต้องอยู่ระหว่าง 0.40 ถึง 2.50

elements[].reference_image_urlsไม่บังคับ

ประเภทurl[] · image

ระบุรูปภาพอ้างอิงเพิ่มเติม 1–3 รูปที่แสดงมุมมองแตกต่างกัน รูปภาพแต่ละรูปต้องมีอัตราส่วนภาพระหว่าง 0.40 ถึง 2.50 มีขนาดอย่างน้อย 300px ในทั้งสองมิติ และมีขนาดไม่เกิน 50.0MB

จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling-video/v3/pro/motion-control",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1680,
    "usd": "1.68",
    "charged": 1680,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "character_orientation": "image"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

ไฟล์ของคุณ คุณเลือกเองทุก outputs[].url คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=

รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง

ฟิลด์ของเอาต์พุต

video: object {url, content_type, file_name, file_size}วิดีโอที่สร้างโดยโมเดล

โมเดลเพิ่มเติม: วิดีโอเป็นวิดีโอ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/kling-video/v3/pro/motion-control.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอ

เรียกใช้คำขอนี้

เกี่ยวกับ Kling Video · v3 · Pro · Motion Control

พารามิเตอร์

เอาต์พุต

รูปแบบอื่นของ Kling Video

Kling Video · v3 · Standard · Motion Control รูปแบบ: 2

โมเดลเพิ่มเติม: วิดีโอเป็นวิดีโอ

Kling O1 Edit Video [Pro] รูปแบบ: 8

Kling O1 Edit Video [Standard] รูปแบบ: 8

Kling O1 Reference Video to Video [Pro] รูปแบบ: 8

Kling O1 Reference Video to Video [Standard] รูปแบบ: 8