Bỏ qua để đến nội dung
Mở CastalyBảng điều khiển

Video

kling-3.0-omni API

Sử dụng ID mẫu kling-3.0-omni chính xác thông qua định tuyến video không đồng bộ Modelflare.

Sử dụng ID mẫu chính xác kling-3.0-omni. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫukling-3.0-omniPOST /v1/videos5.0s

Thông số: duration=5resolution=1080pratio=16:9

Câu lệnh: One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

Yêu cầu tạo ra mẫu này
{
"model": "kling-3.0-omni",
"prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.",
"seconds": "5",
"duration": 5,
"resolution": "1080p",
"ratio": "16:9",
"aspect_ratio": "16:9"
}

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP
Authorization: Bearer YOUR_MODELFLARE_API_KEY
Terminal windowbash
curl https://modelflare.dev/v1/videos \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model_name": "kling-3.0-omni",
"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
"duration": "5", "mode": "std"
}'

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

Terminal windowbash
curl https://modelflare.dev/v1/videos/TASK_ID \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Kling sử dụng các trường model_name, prompt, mode, duration, image_list hoặc contents / settings dành riêng cho họ; JSON gốc được bảo tồn và chuyển tiếp.

Kling Omni/O1 sử dụng model_name, prompt và danh sách phương tiện. Tuân theo các ràng buộc chính thức của từng mẫu máy khi kết hợp image_list, video_list, element_list, multi_shot và sound.

Cánh đồng Bắt buộc Ghi chú
model_name Có kling-3.0-omni
prompt Có điều kiện Bắt buộc khi tắt tính năng chụp nhiều ảnh
mode Không std / pro
aspect_ratio Có điều kiện 16:9 / 9:16 / 1:1
duration Không 3–15 giây (chuỗi)
image_list Không Tham chiếu khung hình đầu tiên/cuối, cảnh hoặc kiểu; Omni/O1 cho phép nhiều mục trong giới hạn mô hình
video_list Không Tham khảo về chỉnh sửa hoặc phong cách video
element_list Không ID phần tử Kling; sự tích hợp này không cung cấp khả năng quản lý phần tử
multi_shot Không Kích hoạt tính năng tạo kịch bản phân cảnh nhiều cảnh
sound Không Có tạo âm thanh đồng bộ hay không

Omni hỗ trợ 720p/1080p/4k, 3–15 giây, tham chiếu hình ảnh/video/thành phần và tối đa sáu ảnh chụp bảng phân cảnh. Tắt sound khi có video tham chiếu.

Ví dụ về quy trình làm việc được ghi lại

Phần tiêu đề “Ví dụ về quy trình làm việc được ghi lại”
Terminal windowbash
curl https://modelflare.dev/v1/videos \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model_name": "kling-3.0-omni",
"prompt": "让图 1 中的人物在雨中向镜头挥手",
"image_list": [{"image_url": "https://example.com/character.png"}],
"duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
}'

Các video tham khảo, thành phần và sự kết hợp nhiều cảnh quay phải tuân theo giới hạn của trang này; tắt sound khi có video tham chiếu.

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Mô hình này sử dụng tính phí video theo giây. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Hợp đồng truyền thông · v1

ID hợp đồng: media.kling-3-0-omni.v1Bộ chuyển đổi: video.kling.omni.v1@v1Dấu vân tay: 70c3e0fcc5727858f11c8e080f06c223e40cb2e20363d856fbb2fcfa79e4d9b1

Nguồn chính thức: Kuaishou Kling

Thông số hợp đồng

Trường ý địnhĐiều khiểnTùy chọn
ratioselect16:9 / 9:16 / 1:1
resolutionselect720p / 1080p / 4k
durationselect3 / 5 / 8 / 10 / 15
audioswitch—

Khả năng được hỗ trợ

  • allowed_values · ratio · 16:9, 9:16, 1:1
  • allowed_values · resolution · 720p, 1080p, 4k
  • allowed_values · duration · 3, 5, 8, 10, 15
  • max_assets · reference_asset_ids · 7

Ví dụ về yêu cầu có cấu trúc

text

Ý định

{
  "audio": false,
  "duration": 3,
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "16:9",
  "resolution": "720p"
}

Yêu cầu của nhà cung cấp

{
  "aspect_ratio": "16:9",
  "duration": "3",
  "mode": "std",
  "model_name": "kling-3.0-omni",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "sound": "off"
}

reference

Ý định

{
  "audio": false,
  "duration": 3,
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "16:9",
  "resolution": "720p"
}

Yêu cầu của nhà cung cấp

{
  "aspect_ratio": "16:9",
  "duration": "3",
  "image_list": [
    {
      "image_url": "https://example.com/reference.png"
    }
  ],
  "mode": "std",
  "model_name": "kling-3.0-omni",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "sound": "off"
}