Tạo video

Tạo tác vụ Kling 4.0 từ văn bản, hình ảnh hoặc Omni theo định dạng nền tảng.

Dùng trường chung cho đầu vào cơ bản, metadata.contents cho đầu vào nâng cao. Đặt cấu hình tạo trong metadata.settings, callback và hình mờ trong metadata.options.

POST/v1/video/generations

Dùng trường nền tảng và metadata cho văn bản, ảnh hoặc Omni. Đường dẫn thay thế POST /v1/videos/generations nhận cùng tham số. Các thao tác dùng cùng kling-4.0; Omni là khả năng đa tham chiếu, không phải mô hình khác.

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.

Nhập prompt/tài nguyên qua prompt hoặc metadata.contents tùy thao tác; không đặt trường gốc trực tiếp ở cấp cao nhất.

model*"kling-4.0"

Các thao tác cùng dùng Kling 4.0.

Giá trị mặc định"kling-4.0"

Giá trị được phép

"kling-4.0"

prompt?Prompt

Prompt có thể chứa mô tả tích cực và tiêu cực. Chỉ tiếng Anh tối đa 26000 ký tự, chỉ ngôn ngữ khác tối đa 11000. Hỗn hợp phải thỏa E/26000 + N/11000 <= 1; E là ký tự tiếng Anh, N là ký tự khác.

image?string

URL ảnh đơn, đầu vào nhanh cho ảnh thành video.

images?array<string>

Một ảnh là khung đầu, hai ảnh là đầu/cuối. Nhiều hơn dùng metadata.contents có kiểu.

duration?integer

Trường nhanh thời lượng tính bằng giây. metadata.settings chỉ định rõ có ưu tiên.

Phạm vi3 <= value <= 30

seconds?integer

Trường nhanh thời lượng nền tảng. Chỉ dùng một cách biểu diễn; metadata.settings chỉ định rõ có ưu tiên.

Phạm vi3 <= value <= 30

size?string

Trường nhanh độ phân giải: 720p/1080p, không phải pixel. Ưu tiên metadata.settings.resolution, không nhập trùng size.

Giá trị được phép

"720p"
"1080p"

metadata?

Cấu hình mở rộng gốc. settings chỉ định rõ có ưu tiên; giữ false và 0 nhưng vẫn phải thỏa ràng buộc trường của thao tác gốc.

Nội dung phản hồi

`application/json`

curl -X POST "https://api.agtcloud.cn/v1/video/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0",
    "prompt": "Khu công nghệ ven biển đầy nắng, máy quay chậm rãi bay vòng quanh tòa nhà trắng.",
    "metadata": {
      "operation": "text-to-video",
      "settings": {
        "duration": 3,
        "resolution": "720p"
      },
      "options": {
        "watermark_info": {
          "enabled": false
        }
      }
    }
  }'

{
  "id": "123456789012345678",
  "task_id": "123456789012345678",
  "object": "video",
  "model": "kling-4.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1792732542
}

Kết quả tạo và truy vấn

Khi tạo thành công, API trả đối tượng tác vụ cấp cao nhất; id và task_id là ID dạng chuỗi. Lưu task_id rồi dùng API truy vấn nền tảng để lấy trạng thái và URL video.

status: "queued" nghĩa là đã tiếp nhận và xếp hàng; progress: 0 không có nghĩa là tạo thất bại. Phản hồi tạo chưa có URL video cuối cùng. created_at là thời gian Unix tính bằng giây, khác mili giây của phản hồi gốc.

Chọn cách nhập

Tình huống	Đầu vào	Quy tắc chi tiết
Văn bản thành video	`prompt`; cấu hình nâng cao chỉ định `metadata.operation: "text-to-video"`	Tham số văn bản
Ảnh thành video	`image` / `images` hoặc `metadata.contents` có kiểu; thao tác `image-to-video`	Nguồn ảnh và giới hạn khung hình chính
Omni tham chiếu/chỉnh sửa	Dùng `metadata.operation: "omni-video"` và `metadata.contents`	Kiểu tài nguyên, tham chiếu và tổ hợp

metadata.settings được chỉ định rõ có ưu tiên hơn trường nhanh. Tham chiếu id của ảnh/video là tùy chọn; id của phần tử/giọng nói là bắt buộc. Mọi ID tham chiếu đã điền phải duy nhất trong tác vụ.

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 `Authorization: Bearer your-api-key` và API Key hợp lệ của trang được gọi
HTTP 400, `模型名称不能为空`	Điền `model: "kling-4.0"`
HTTP 400, `prompt cannot be empty`	Văn bản thành video cần `prompt` không rỗng; nhập `metadata.contents` theo thao tác gốc tương ứng
HTTP 400, `duration must be an integer`	Dùng số nguyên như `3`, không dùng chuỗi `"3"` hoặc số thập phân
`settings.resolution ... is invalid`	Dùng `720p` hoặc `1080p` thay cho kích thước pixel; bỏ `size` và thống nhất dùng `metadata.settings.resolution`
HTTP 400, `invalid JSON request body`	Kiểm tra dấu nháy, phẩy, ngoặc; nội dung phải là JSON hợp lệ, không có chú thích

HTTP 400 có thể trả code/message/data hoặc đối tượng error. Khi tạo, code: "fail_to_fetch_task" cũng có thể là lỗi kiểm tra tham số từ dịch vụ nguồn. Đọc nguyên nhân trong message thay vì liên tục gửi lại chỉ dựa trên mã nghiệp vụ.

message có thể là chuỗi JSON chứa code/message/request_id, không phải đối tượng đã phân tích. Kiểm tra định dạng rồi phân tích. Lưu ID yêu cầu để được hỗ trợ, không cung cấp API Key. Giới hạn đầu vào theo thao tác gốc tương ứng; phạm vi trong lỗi kiểm tra chung không xác định khả năng mô hình.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

Kết quả tạo và truy vấn

Chọn cách nhập

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

`application/json`

`application/json`

`application/json`