Tạo video Omni

Tạo hoặc chỉnh sửa video Kling 4.0 bằng nhiều loại tài nguyên tham chiếu.

feature_video tham chiếu đặc điểm, nhịp chuyển động; base_video chỉnh sửa video có sẵn. Tổng ảnh/video/phần tử/giọng nói tối đa 15 mục và phải tuân thủ giới hạn từng loại. Phần tử, giọng nói dùng ID có sẵn; trang này không bao gồm API quản lý tài nguyên.

POST/kling/omni-video/kling-4.0

Kết hợp prompt, ảnh, video, phần tử và giọng nói để tạo/chỉnh video. feature_video để tham chiếu, base_video để chỉnh sửa. Cùng mô hình Kling 4.0 với hai API tạo còn lại.

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng API Key nền tảng: Authorization: Bearer your-api-key.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

contents*array<||||>

Prompt cùng tài nguyên tùy chọn; tổng ảnh, video, phần tử, giọng nói không quá 15 và đáp ứng giới hạn riêng.

Số phần tử1 <= items

settings?

options?

Nội dung phản hồi

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/omni-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "Dựa phong cách @scene để tạo video quay bờ biển từ trên cao."
      },
      {
        "type": "refer_image",
        "id": "scene",
        "url": "https://example.com/scene.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "adaptive"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Loại tài nguyên và tham chiếu

contents phải có mục prompt type: "prompt"; thêm tài nguyên khác khi cần. id dùng cho @reference trong prompt; mọi ID tham chiếu phải duy nhất trong tác vụ.

Tài nguyên	`type`	Nguồn và trường bắt buộc
Ảnh	`first_frame` / `middle_frame` / `last_frame` / `refer_image`	`url` bắt buộc, URL/Base64; `id` tùy chọn
Video	`feature_video` / `base_video`	`url` bắt buộc, URL video; `id` tùy chọn
Phần tử	`element`	Cả `element_id` và `id` bắt buộc
Giọng nói	`voice`	Cả `voice_id` và `id` bắt buộc

element_id là ID phần tử do hệ thống tạo, lấy từ API phần tử. voice_id là ID giọng nói; lấy giọng tùy chỉnh từ API tương ứng hoặc dùng giọng cài sẵn trong tài liệu chính thức. Chúng khác tham chiếu id trong yêu cầu.

Xem hướng dẫn thư viện phần tử chính thức và tài liệu tùy chỉnh giọng nói chính thức. Dùng ID đúng khu vực, không dùng lại ID cài sẵn của khu vực khác.

Giới hạn tài nguyên

Tài nguyên	Định dạng/kích thước	Kích thước, thời lượng, số lượng
Ảnh	JPG, JPEG, PNG; tối đa 30MB mỗi ảnh	Rộng/cao ít nhất 300px; tỷ lệ 2:5～5:2; tối đa 10 ảnh
Video	MP4, MOV; tối đa 300MB mỗi tệp	Mỗi đoạn và tổng đầu vào 3～30 giây; rộng/cao 700～4553px, tổng pixel không quá 8294400; tỷ lệ 2:5～5:2; đầu vào 24～60fps, đầu ra 24fps
Phần tử	Nhiều ảnh hoặc nhân vật video	Tối đa 7, trong đó nhân vật video tối đa 3
Giọng nói	Giọng tùy chỉnh có sẵn hoặc cài sẵn hệ thống	Tối đa 3

Khi kết hợp, còn phải đáp ứng:

Tổng ảnh, video, phần tử và giọng nói không quá 15 mục.
Video và phần tử nhân vật video cộng lại không quá 5; tối đa 1 base_video.
Tổng thời lượng đầu vào gồm feature_video, base_video và video nguồn của phần tử nhân vật video.

Lỗi thường gặp và cách xử lý

Phản hồi/lỗi	Kiểm tra và xử lý
HTTP 401, `Invalid token`	Kiểm tra định dạng Bearer và trang của API Key
HTTP 400, `contents cannot be empty`	Cung cấp mảng `contents` không rỗng
HTTP 400, `prompt cannot be empty`	Thêm mục văn bản `type: "prompt"` không rỗng vào `contents`
HTTP 400, `contents[0].type ... is invalid`	Dùng kiểu được liệt kê và kiểm tra mục tại chỉ số báo lỗi
HTTP 400, `Invalid element id`	Kiểm tra `element_id`; không dùng tham chiếu `id` thay ID phần tử
HTTP 400, `Invalid voice id`	Kiểm tra `voice_id`; không dùng tham chiếu `id` thay ID giọng nói
HTTP 400, `invalid JSON request body`	Kiểm tra nháy, phẩy, ngoặc và chú thích JSON

HTTP 400 có thể trả code/message/data hoặc đối tượng error. Nguyên nhân fail_to_fetch_task ở message, có thể là chuỗi JSON chứa code/message/request_id. Lưu ID yêu cầu, không cung cấp API Key.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

Loại tài nguyên và tham chiếu

Giới hạn tài nguyên

Lỗi thường gặp và cách xử lý

`application/json`

`application/json`

`application/json`