Bỏ qua đến nội dung

Kling Video · v3 · Pro · Motion Control

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 1,68 $ 1.680 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Kling Video sang video Đầu vào tham chiếu #stylized#transform#editing

Chuyển chuyển động cấp Pro, áp dụng chuyển động nhân vật trong video tham chiếu lên ảnh nhân vật

Kling · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

0 / 2500
•bắt buộc image_url
Thả tệp hoặc

URL hình ảnh tham chiếu để tạo video, giới hạn kích thước tệp 10.0MB, chiều rộng và chiều cao mỗi chiều từ 340px đến 3850px, tỷ lệ khung hình từ 0.40 đến 2.50. Hình ảnh này định hướng nhân vật, nền và các phần tử khác của video. Với nhân vật, cần bảo đảm tỷ lệ cơ thể rõ ràng, không bị che khuất và chiếm hơn 5% diện tích hình ảnh.

•bắt buộc video_url
Thả tệp hoặc

URL trỏ đến video có hành động nhân vật định hướng đầu ra; video nên thể hiện nhân vật phong cách chân thực, không bị che khuất, thấy đầu và toàn thân hoặc phần thân trên. Thiết lập character_orientation giới hạn thời lượng ở 10s cho 'image' hoặc 30s cho 'video'. Giới hạn tệp: tối đa 100 MB, chiều rộng và chiều cao mỗi chiều từ 340px đến 3850px, thời lượng từ 3.0s đến 30.05s.

character_orientation •bắt buộc

Nguồn định hướng nhân vật: 'image' khớp với hình ảnh tham chiếu và phù hợp hơn để bám theo chuyển động máy quay, tối đa 10 giây. Với chuyển động phức tạp, 'video' phù hợp hơn: khớp với hướng của video tham chiếu và cho phép tối đa 30 giây.

Nâng cao enable_safety_checker · keep_original_sound · elements

Liên kết phần tử khuôn mặt tùy chọn để cải thiện khả năng giữ danh tính trong video đầu ra, giới hạn 1 phần tử đã tải lên. Dùng @Element1 để tham chiếu trong lời nhắc. Liên kết chỉ khả dụng khi character_orientation được đặt thành 'video'.

POST /run/kling-video/v3/pro/motion-control?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Kling Video · v3 · Pro · Motion Control

Kết hợp ảnh nhân vật trong `image_url` với chuyển động từ video tham chiếu trong `video_url`. Bắt buộc có `character_orientation` để chọn hướng theo ảnh hoặc video. Hỗ trợ `prompt` tùy chọn dài tối đa 2500 ký tự, `keep_original_sound` giữ âm thanh tham chiếu và liên kết một phần tử khuôn mặt qua `elements` để giúp duy trì danh tính.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Chỉ có thể tắt kiểm tra an toàn khi tài khoản được ủy quyền; các yêu cầu không có quyền ủy quyền luôn được kiểm tra.
prompttùy chọn
Kiểustring | null
≤ 2.500 ký tự
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh tham chiếu để tạo video, giới hạn kích thước tệp 10.0MB, chiều rộng và chiều cao mỗi chiều từ 340px đến 3850px, tỷ lệ khung hình từ 0.40 đến 2.50. Hình ảnh này định hướng nhân vật, nền và các phần tử khác của video. Với nhân vật, cần bảo đảm tỷ lệ cơ thể rõ ràng, không bị che khuất và chiếm hơn 5% diện tích hình ảnh.
video_urlbắt buộc video
Kiểuurl · video
URL trỏ đến video có hành động nhân vật định hướng đầu ra; video nên thể hiện nhân vật phong cách chân thực, không bị che khuất, thấy đầu và toàn thân hoặc phần thân trên. Thiết lập character_orientation giới hạn thời lượng ở 10s cho 'image' hoặc 30s cho 'video'. Giới hạn tệp: tối đa 100 MB, chiều rộng và chiều cao mỗi chiều từ 340px đến 3850px, thời lượng từ 3.0s đến 30.05s.
keep_original_soundtùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc giữ lại âm thanh gốc của video tham chiếu.
character_orientationbắt buộc
Kiểuenum
imagevideo
Nguồn định hướng nhân vật: 'image' khớp với hình ảnh tham chiếu và phù hợp hơn để bám theo chuyển động máy quay, tối đa 10 giây. Với chuyển động phức tạp, 'video' phù hợp hơn: khớp với hướng của video tham chiếu và cho phép tối đa 30 giây.
elementstùy chọn
Kiểuobject[]
Liên kết phần tử khuôn mặt tùy chọn để cải thiện khả năng giữ danh tính trong video đầu ra, giới hạn 1 phần tử đã tải lên. Dùng @Element1 để tham chiếu trong lời nhắc. Liên kết chỉ khả dụng khi character_orientation được đặt thành 'video'.
elements[].frontal_image_urltùy chọn
Kiểuurl · image
Hình ảnh chính diện thể hiện góc nhìn chính của phần tử. Kích thước tệp không được quá 50 MB; chiều rộng và chiều cao mỗi chiều ít nhất 300px, với tỷ lệ khung hình từ 0.40 đến 2.50.
elements[].reference_image_urlstùy chọn
Kiểuurl[] · image
Cung cấp 1–3 hình ảnh tham chiếu bổ sung ở các góc khác nhau. Mỗi hình ảnh phải có tỷ lệ khung hình từ 0.40 đến 2.50, kích thước ít nhất 300px ở cả hai chiều và không lớn hơn 50.0MB.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video do mô hình tạo ra.

Thêm mô hình: Video sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/kling-video/v3/pro/motion-control.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt