Văn bản thành video

Prompt có thể mô tả cả nội dung mong muốn và cần tránh. settings điều khiển thời lượng, độ phân giải và tỷ lệ; options cấu hình callback, hình mờ.

POST/kling/text-to-video/kling-4.0

Tạo video Kling 4.0 bằng prompt. Mô hình do đường dẫn xác định, không cần model trong nội dung.

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.

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.

settings?

options?

Nội dung phản hồi

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/text-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Bờ biển sáng đẹp, máy quay tiến chậm, sóng vỗ nhẹ bãi cát.",
    "settings": {
      "duration": 3,
      "resolution": "720p"
    }
  }'

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

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, `prompt cannot be empty`	Cung cấp prompt văn bản không rỗng
HTTP 400, `prompt value type is invalid`	`prompt` phải là chuỗi, không phải mảng/đối tượng
HTTP 400, `invalid_request`	Kiểm tra kiểu của `settings.duration` và các trường; thời lượng phải là số nguyên
HTTP 400, lỗi độ phân giải/tỷ lệ	Điền `settings.resolution` và `settings.aspect_ratio` theo các giá trị liệt kê trên trang
HTTP 400, `invalid JSON request body`	Kiểm tra JSON, bỏ chú thích trong nội dung yêu cầu

Kiểm tra chung có thể liệt kê phạm vi rộng hơn mô hình cung cấp. API này dùng thời lượng nguyên 3～30 giây, 720p hoặc 1080p. Không suy ra thời lượng/độ phân giải khác chỉ từ thông báo lỗi.

Lỗi tạo có thể trả code/message/data hoặc đối tượng error, khác cấu trúc thành công. Nguyên nhân của 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

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

`application/json`

`application/json`

`application/json`