Tạo video từ văn bản

Tạo tác vụ video từ văn bản hoặc Omni/O1 qua API nguyên bản Kling.

Tạo video từ văn bản tiêu chuẩn và Omni/O1 sử dụng cùng phương thức và đường dẫn yêu cầu, nhưng biểu thị đầu vào bằng các cấu trúc yêu cầu khác nhau.

POST/kling/v1/videos/text2video

Sử dụng trực tiếp các trường nguyên bản của Kling. Nền tảng phụ trách xác thực và định tuyến, không chuyển đổi Payload sang định dạng chung.

Omni/O1 sử dụng cùng đường dẫn tạo tác vụ nguyên bản, phân biệt đầu vào bằng mô hình và các trường tư liệu.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Yêu cầu nguyên bản Kling để tạo video từ văn bản hoặc Omni/O1.

Định nghĩa kiểu TypeScript

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

model*string

ID mô hình nguyên bản Kling, ví dụ kling-v2-5-turbo và kling-v2-6. Mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

Độ dài1 <= length

prompt*string

Prompt mô tả nội dung mong muốn, không quá 2500 ký tự.

Độ dàilength <= 2500

negative_prompt?string

Prompt mô tả nội dung cần tránh.

Độ dàilength <= 2500

mode?string

Chế độ tạo video. V1.6 không hỗ trợ pro.

Giá trị được phép

"std"
"pro"

aspect_ratio?string

Tỷ lệ khung hình đầu ra.

Giá trị mặc định"16:9"

Giá trị được phép

"16:9"
"9:16"
"1:1"

duration_string?string

Thời lượng video, tính bằng giây.

Giá trị được phép

"5"
"10"

cfg_scale?number

Mức độ bám sát prompt.

Phạm vi0 <= value <= 1

sound?string

Có tạo âm thanh hay không. Chỉ mô hình V2.6 trở lên hỗ trợ.

Giá trị được phép

"on"
"off"

voice_list?array<>

Danh sách giọng nói tham chiếu.

Số phần tửitems <= 2

callback?string

URL callback cho trạng thái tác vụ.

Định dạnguri

params?string

Tham số được chuyển tiếp nguyên trạng trong callback.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/kling/v1/videos/text2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Một chú mèo đang hát trên sân khấu, phong cách điện ảnh",    "negative_prompt": "Mờ, độ nét thấp",    "mode": "std",    "aspect_ratio": "16:9",    "duration_string": "5",    "cfg_scale": 0.5,    "sound": "on",    "callback": "https://example.com/kling/callback",    "params": "user_id_123"  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`