Kling 4.0 Flash

Kling 4.0 Flash là mô hình gọn nhẹ hơn trong dòng Kling 4.0 của Kuaishou. Trên SeedRouter, mô hình hỗ trợ tạo video từ văn bản và theo tham chiếu: tối đa 10 ảnh tham chiếu, tối đa 5 video tham chiếu và tối đa 7 chủ thể (đối tượng có tên được tạo từ 2–4 ảnh hoặc một video ngắn), mỗi mục đều được nhắc đến trong prompt. Mỗi clip dài 3–20 giây ở 720p có âm thanh. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc video hoàn chỉnh từ tác vụ. Media được truyền vào dưới dạng URL.

ID mô hình

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Điểm cuối

POST https://api.seedrouter.ai/v1/videos/generations

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn chỉnh. Truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Giữ API key trong mã phía máy chủ.

Tham số

Mỗi clip đều có âm thanh; không có tùy chọn bật tắt âm thanh. Không có trường khung hình đầu, giữa hoặc cuối, trường negative_prompt, watermark hay trường voices riêng: gắn giọng nói với một chủ thể bằng voice_url. Schema nghiêm ngặt: các trường không xác định bị từ chối thay vì bỏ qua. callback_url không khả dụng; thay vào đó hãy truy vấn tác vụ.

Nhắc đến tư liệu

Mọi tư liệu bạn gửi đều là tùy chọn; nếu không gửi tư liệu nào, yêu cầu chỉ tạo video từ văn bản. Khi gửi tư liệu, hãy nhắc đến chúng trong prompt:

Mỗi @ theo sau bởi chữ cái, chữ số, dấu gạch dưới hoặc chữ Hán phải chỉ đến một tư liệu trong yêu cầu này, nếu không yêu cầu bị từ chối trước khi tính bất kỳ khoản phí nào. Tên được so khớp từ dài nhất trước và không phân biệt chữ hoa chữ thường. Tên kết thúc bằng chữ cái, chữ số hoặc dấu gạch dưới không được nối liền với một ký tự thuộc các loại đó: @image_12 khi chỉ có một ảnh sẽ bị từ chối; hãy viết @image_1 2 hoặc @image_1,.

Video tham chiếu và chủ thể từ video cộng lại tối đa 5, còn ảnh, video và chủ thể cộng lại tối đa 15.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Chủ thể

Chủ thể là một đối tượng có tên mà bạn có thể tái sử dụng trong prompt. Có hai loại:

Tên dài 1–20 ký tự gồm chữ cái, chữ số, dấu gạch dưới hoặc chữ Hán, phải duy nhất không phân biệt chữ hoa chữ thường. image_N, video_N, keyframe_N, object_N, audio_N, first_frame và last_frame là các tên dành riêng.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Media đầu vào

Ảnh, video và audio là URL HTTP(S) công khai. URI dữ liệu Base64 không chấp nhận: tải tệp lên bộ nhớ của riêng bạn và truyền URL của chúng. Tổng độ dài video tham chiếu và chủ thể từ video phải là 2–20 giây; độ dài được đọc khi yêu cầu được chấp nhận và video không đọc được độ dài sẽ bị từ chối trước khi tính bất kỳ khoản phí nào.

Chiều kích giá

Xem phần giá mô hình để biết mức giá hiện tại. Kling 4.0 Flash được tính phí theo giây video 720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input là tổng độ dài của video tham chiếu và chủ thể từ video, làm tròn lên số nguyên giây. Độ dài được đo khi yêu cầu được chấp nhận, vì vậy số tiền tạm giữ chính là số tiền tính phí. Ví dụ: clip dài 5 giây theo video tham chiếu dài 7,2 giây được tính phí 5 + 8 = 13 giây; với video tham chiếu dài 3 giây thì tính phí 5 + 5 = 10 giây. Tác vụ không thành công không bị tính phí.

Lược đồ đầu ra

Gửi trả về tác vụ:

{"id": "task_...", "model": "kling-4-0-flash", "status": "processing", "created_at": 1789689600}

Lấy tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Truy vấn mỗi 10–20 giây cho đến khi status là completed hay failed. Hết thời gian mạng khi truy vấn không có nghĩa tạo không thành công: giữ ID tác vụ và tiếp tục kiểm tra nó. Không tạo tác vụ khác để kiểm tra tiến độ.

Tác vụ hoàn chỉnh

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Trong thử nghiệm của chúng tôi, clip dài 5 giây trả về dưới dạng MP4 (H.264) ở 1280 × 720 với track AAC stereo, sau 91–103 giây kể từ khi gửi; tệp dài hơn duration khoảng một khung hình (5,04 giây cho giá trị 5).

Lỗi

Yêu cầu bị từ chối trước khi tác vụ được tạo trả về lỗi HTTP với đối tượng error và không bị tính phí. Tác vụ không thành công sau khi chấp nhận trả về HTTP 200 khi truy vấn, với status: "failed" và đối tượng error.

Xem danh mục lỗi chung để biết các mã, trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "kling-4-0-flash",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Nếu gửi hết thời gian, kiểm tra tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được chấp nhận.

Mẹo

• Mô tả đối tượng, địa điểm, chuyển động máy quay, ánh sáng và âm thanh; audio của clip làm theo prompt.
• Dùng Flash để thử prompt, tỷ lệ khung hình và tham chiếu với chi phí thấp, rồi chuyển cảnh quay hiệu quả sang Kling 4.0 khi cần 1080p, khung hình chính, chỉnh sửa hoặc kéo dài.
• Với nhân vật xuất hiện nhiều lần, tạo một chủ thể từ hai hoặc ba góc nhìn rõ ràng thay vì một ảnh tham chiếu.
• Thêm no text, no logos để tránh các ký hiệu tự tạo.

Liên quan

• Playground Kling 4.0 Flash và giá
• Tham chiếu API Kling 4.0
• Tải OpenAPI
• Markdown có thể sao chép