Kling V4 Flash

Đặc tả APIMaster kling-v4-flash, kiểm tra ngày 2026-11-07. Kênh 317 hỗ trợ văn bản, khung đầu, tham chiếu, chỉnh sửa và nối dài. Chỉ 720p, 24fps, 3–20 giây; khác mô hình Kling V4.

Kling V4 Flash

Điểm cuối và xác thực

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Tham số

Dùng JSON và Authorization: Bearer YOUR_API_KEY; model=kling-v4-flash. prompt bắt buộc trừ một ảnh đầu duy nhất. duration/seconds: số nguyên JSON 3–20, mặc định 5; null là bỏ qua, 0 bị từ chối. Nếu có cả hai thì phải hợp lệ và bằng nhau. Chỉnh sửa không có thời lượng dùng thời gian luồng video làm tròn lên. resolution chỉ 720p. aspect_ratio hoặc bí danh size: 16:9, 9:16, 1:1, 21:9; auto chỉ cho tham chiếu. Mặc định văn bản 16:9, tham chiếu auto, chỉnh sửa theo nguồn. Tạo từ ảnh và nối dài không nhận aspect_ratio/size khác rỗng. audio chỉ true, watermark chỉ false.

Tham số	Kiểu JSON	Bắt buộc	Mặc định	Ý nghĩa và giới hạn
model	string	Có	kling-v4-flash	Luôn là kling-v4-flash cho cả năm thao tác; kling-v4 là mô hình khác.
prompt	string	Theo chế độ	—	Mô tả cảnh, chuyển động hoặc thay đổi. Chỉ được bỏ khi dùng một ảnh đầu. @Image1 và @Video1 được đánh số riêng từ 1 theo thứ tự mảng; video chỉnh sửa là @Video1.
duration	integer / null	Không	5	Số nguyên JSON 3–20 giây, thường mặc định 5. Chỉnh sửa bỏ cả hai trường sẽ làm tròn lên thời lượng luồng video đầu vào; mở rộng là độ dài đoạn MỚI. null là bỏ qua; từ chối 0, số không nguyên và chuỗi số.
seconds	integer / null	Không	—	Bí danh duration, cùng giới hạn. Nên dùng một trường; nếu gửi cả hai thì phải hợp lệ và bằng nhau, nếu không trả 400.
resolution	string	Không	720p	Chỉ 720p; đây là mức chất lượng, không đảm bảo cạnh ngắn luôn 720px. Không hỗ trợ 1080p hay chọn chất lượng bằng mode.
aspect_ratio	string	Không	Theo chế độ	Văn bản/tham chiếu/chỉnh sửa: 16:9, 9:16, 1:1, 21:9; auto chỉ cho tham chiếu. Mặc định: văn bản 16:9, tham chiếu auto, chỉnh sửa theo nguồn. Ảnh đầu và mở rộng không nhận giá trị khác rỗng; chuỗi rỗng được bỏ qua.
size	string	Không	—	Bí danh aspect_ratio, không phải độ phân giải hay kích thước pixel. Hai trường phải khớp nếu cùng gửi; bỏ cả hai cho ảnh đầu và mở rộng.
image_urls	string[]	Theo chế độ	—	Mảng URL ảnh công khai. Auto chỉ nhận một ảnh đầu; tham chiếu chỉ có ảnh phải ghi reference. Tham chiếu/chỉnh sửa tối đa 10 ảnh, tính cả vai trò reference_image. Không trộn cách khai báo ảnh đầu; mở rộng không nhận ảnh.
first_frame_image	string	Theo chế độ	—	URL công khai của ảnh đầu duy nhất, thay thế một phần tử image_urls hoặc vai trò first_frame, không gửi đồng thời. Hai chiều ≥300px, tỷ lệ 2:5–5:2; cắt ảnh trước nếu cần.
image_with_roles	{url, role}[]	Theo chế độ	—	Mỗi đối tượng cần url công khai và role. first_frame cho ảnh đầu duy nhất, reference_image cho tham chiếu/chỉnh sửa. Không nhận khung cuối/giữa/khung chính. Tổng ảnh tham chiếu≤10, ảnh và video tham chiếu≤15.
video_url	string	Theo chế độ	—	URL một video nguồn, phải chỉ rõ edit/extend và không dùng cùng video_urls. Chỉnh sửa cần MP4/MOV, luồng video 3–20s, mỗi chiều 700–4553px. Mở rộng từ khung cuối, chỉ trả đoạn mới; không nhập ID tác vụ/hội thoại.
video_urls	string[]	Theo chế độ	—	Tối đa 5 MP4/MOV tham chiếu, mỗi luồng≥3s, mỗi chiều 700–4553px, tổng≤20s. Edit/extend có thể dùng đúng một phần tử thay video_url. Vượt giới hạn bị từ chối, không cắt tự động; mảng tự chọn chế độ tham chiếu.
omni_reference_task_type	string	Không	auto	auto suy ra văn bản/ảnh đầu/tham chiếu; reference cần tư liệu tham chiếu; edit/extend cần đúng một video. video_url thiếu chế độ rõ ràng và hai ảnh thường trong auto đều không hợp lệ.
audio_setting	string	Không	auto	Chỉ cho tham chiếu CÓ VIDEO. auto tạo âm thanh mới; origin giữ âm thanh video ĐẦU TIÊN, không có track thì đầu ra cũng không có. Bỏ trường này khi chỉnh sửa, mở rộng, văn bản hoặc chỉ tham chiếu ảnh.
audio	boolean	Không	true	Boolean tương thích: bỏ qua hoặc true; false bị từ chối. Giữ âm gốc bằng audio_setting ở chế độ hỗ trợ. Không nhận tệp âm thanh tham chiếu riêng.
watermark	boolean	Không	false	Boolean tương thích: bỏ qua hoặc false; true bị từ chối. Không phải dịch vụ xóa watermark nguồn.

Dùng URL HTTP(S) công khai trực tiếp, không kèm thông tin đăng nhập; không base64/đường dẫn cục bộ/ID tác vụ. Định dạng và giới hạn byte ảnh chưa công bố riêng. 100MiB là giới hạn đọc từng video tham chiếu/chỉnh sửa được thăm dò, không phải giới hạn tải lên chung.

Chế độ và tư liệu

Thao tác	Cách chọn và tư liệu cần có	Mặc định và loại trừ
Văn bản → video	Không tư liệu, prompt bắt buộc, loại auto hoặc bỏ qua.	5s, 16:9; không audio_setting.
Ảnh đầu → video	Một ảnh qua MỘT trong ba cách, prompt tùy chọn.	5s, theo tỷ lệ ảnh; bỏ aspect_ratio/size, không ảnh cuối.
Tham chiếu → video	reference + ảnh, vai trò reference_image hoặc video_urls; cần prompt.	5s, auto; ảnh≤10, video≤5, tổng≤15; tùy chọn âm thanh cần video.
Chỉnh sửa	edit + một video, cần prompt; tối đa 10 ảnh tham chiếu.	Thời lượng nguồn làm tròn lên, tỷ lệ theo nguồn; không vai trò khung/audio_setting.
Mở rộng	extend + một video, cần prompt.	5 giây MỚI; không ảnh, đổi tỷ lệ/audio_setting; không áp dụng kiểm tra kích thước/thời lượng tối thiểu của edit/reference.

omni_reference_task_type: auto, reference, edit, extend. Một image_urls, first_frame_image hoặc vai trò first_frame là khung đầu. Nhiều ảnh cần reference hoặc vai trò reference_image; hai image_urls trong auto bị từ chối. video_urls mặc định tham chiếu trừ khi ghi rõ edit/extend. video_url yêu cầu edit/extend và loại trừ video_urls. Chỉnh sửa/nối dài cần một video. Chỉnh sửa nhận ảnh tham chiếu; nối dài không nhận ảnh/audio_setting, chỉ trả đoạn MỚI. Dùng URL video nguồn công khai, không dùng ID tác vụ hay hội thoại.

URL HTTP(S) trực tiếp công khai, không nhúng thông tin đăng nhập. Tối đa 10 ảnh, tổng 15 tham chiếu ảnh/video. Ảnh tối thiểu 300×300, tỷ lệ 2:5–5:2. Tối đa 5 MP4/MOV, mỗi đoạn ít nhất 3 giây, tổng không quá 20; chỉnh sửa một video 3–20 giây. Cả chiều rộng VÀ cao phải 700–4553 pixel. Cổng đọc tối đa 100 MiB mỗi video, đo luồng video chứ không đo vùng chứa/âm thanh. Kiểm tra kích thước/thời lượng tối thiểu này không áp dụng cho đầu vào nối dài. Nhà cung cấp cũng kiểm tra ảnh. audio_setting=origin giữ âm thanh video tham chiếu đầu hoặc im lặng; auto tạo âm thanh. Chỉ cho tham chiếu CÓ video. Chỉnh sửa tạo âm thanh mới. Không URL âm thanh, khung cuối/giữa, keyframes, negative_prompt, mode, seed, nhiều cảnh hoặc danh sách nhân vật/giọng.

Pixel đầu ra và tốc độ khung hình

Tỷ lệ / thao tác	Pixel được tài liệu công bố	Tốc độ khung hình
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Ảnh đầu → video	Theo tỷ lệ ảnh, khoảng 0,92MP; ví dụ 604×1516 cho 2:5.	24 fps

Kích thước đầu ra khác yêu cầu đầu vào. Video 21:9 cao 628px không đạt tối thiểu 700px cho tham chiếu/chỉnh sửa; cần nguồn phù hợp. Mở rộng không chịu mức tối thiểu này. Tệp có thể dài hơn khoảng một khung.

Ví dụ không thực thi

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Tính phí

Đơn giá cơ sở chính thức danh nghĩa: $0.094 mỗi giây đầu ra (720P), $0.0628 mỗi giây tính phí có video (720P-input). Văn bản, ảnh, tham chiếu không video và nối dài tính đầu ra/đoạn mới. Tham chiếu video và chỉnh sửa: đầu ra + max(đầu vào, đầu ra). Cộng tất cả thời lượng luồng đầu vào trước rồi làm tròn tổng lên giây. Vào 3.04 giây, ra 3: 3+max(4,3)=7 giây tính phí. Thêm khoảng một khung không đổi thời lượng nguyên yêu cầu. Giảm giá gói và hệ số tài khoản tách riêng; xem thẻ và phí cuối trong nhật ký. Lỗi đã xác nhận hoàn khoản giữ trước. Ngừng tra cứu không hủy tác vụ; timeout chưa rõ không cho phép tạo lại.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Trạng thái, lỗi và thử lại an toàn

Lần nhận đầu: HTTP 200, task_id công khai, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, có thể unknown tạm thời. url và metadata.url cần Bearer; cũng tải qua GET /v1/videos/{task_id}/content. Lỗi: error.code=generation_failed kèm thông báo đã lọc; tham số sai: HTTP 400. Idempotency-Key: 8–128 ký tự ASCII hiển thị, không khoảng trắng. Cùng tài khoản/khóa/yêu cầu: HTTP 202, không tạo/giữ tiền lần hai; đổi yêu cầu: 409. GET /v1/video-submissions/by-key đọc biên nhận. accepted+task_ready=true: tra task_id; pending/submitting hoặc chưa sẵn sàng: chờ. acceptance_unknown: giữ khóa, liên hệ hỗ trợ, không tự gửi lại. 404 không chứng minh chưa nhận. Lưu ít nhất 30 ngày; bảo vệ cổng, không tìm ở nhà cung cấp. Phí cuối trong nhật ký theo other.task_id; tra tác vụ không đảm bảo hóa đơn. /v1/videos/quote chưa hỗ trợ. Ví dụ không chạy: thay URL, dùng khóa mới cho thao tác mới.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI