kling-v1-6
Cấu hình kling-v1-6 tạo video từ mô tả cảnh bằng văn bản. Lên kế hoạch cho cảnh quay ngắn với chủ thể, hành động và hướng máy quay rõ ràng, dùng các lựa chọn thời lượng năm hoặc mười giây được ghi trong tài liệu. Quá trình tạo là bất đồng bộ: giữ định danh tác vụ được trả về và lấy video hoàn tất sau khi tác vụ ban đầu thành công.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Bộ chọn chính xác kling-v1-6 xác định cấu hình tạo video từ văn bản của Kling. Gửi JSON đến POST /v1/videos/generations với model đặt thành kling-v1-6 và cảnh bằng văn bản trong prompt. POST /v1/videos cũng chấp nhận cùng yêu cầu tạo. Yêu cầu rõ ràng mô tả những gì nhìn thấy, điều xảy ra trong cảnh quay và cách máy quay quan sát. Yêu cầu cảnh tối thiểu cung cấp bộ chọn mô hình và prompt, để các tùy chọn cảnh quay bổ sung không được chỉ định.
Với cảnh quay sản phẩm, mô tả vật thể, bề mặt, ánh sáng và một hành động nhìn thấy được, như xoay chậm hoặc thay đổi vị trí máy quay. Với ý tưởng cảnh, xác định bối cảnh, chủ thể chính và chuyển động qua khung hình. Giữ hành động dễ nhận biết trong đoạn phim được yêu cầu. Lời nhắc có thể mô tả chiếc thuyền nhỏ băng qua hồ tĩnh lặng, góc rộng từ bờ, ánh sáng sáng sớm và máy quay ổn định đi theo hướng của thuyền.
Giới hạn prompt là 500 ký tự. negative_prompt tùy chọn có thể chứa tối đa 200 ký tự và mô tả các thành phần không mong muốn. Các lựa chọn duration được ghi trong tài liệu cho cấu hình này là 5 và 10 giây. Các giá trị mode là std và pro. cfg_scale là số từ 0 đến 1; tài liệu mô tả giá trị cao hơn là bám sát văn bản hơn. Chọn tùy chọn cho đúng cảnh quay và lưu các giá trị đã gửi cùng kết quả.
Đối tượng camera_control được ghi trong tài liệu liệt kê các loại máy quay simple, down_back, forward_up, right_turn_forward và left_turn_forward. Cấu hình simple của nó nêu các tùy chọn horizontal, vertical, pan, tilt, roll và zoom. Ví dụ văn bản tối thiểu cung cấp điểm khởi đầu hữu ích khi có thể mô tả cảnh mà không cần đối tượng điều khiển máy quay riêng. Đặt mục đích rõ ràng cho chuyển động máy quay trong lời nhắc, như làm lộ chủ thể hoặc theo chuyển động của chủ thể.
Việc gửi yêu cầu khởi tạo tác vụ bất đồng bộ. Giữ id, tiêu đề X-Ailoot-Task-Id và polling_url được trả về, rồi dùng GET trên polling_url đó với cùng khóa API Ailoot để đọc tác vụ ban đầu. Trạng thái tác vụ nằm trong data.task_status: submitted và processing đang chờ, succeed là thành công, còn failed là không thành công. Vì vậy xác nhận gửi yêu cầu là kết quả trung gian. Khi thành công, lấy mọi URL trong data.task_result.videos[].url; đây là các liên kết tệp kết quả do Ailoot quản lý. GET /v1/videos/{id}/content lấy đầu ra đầu tiên và tham số truy vấn index của nó chọn một đầu ra được trả về theo chỉ số bắt đầu từ số không. Giữ phản hồi trạng thái cùng đoạn phim đã chọn. Nếu xảy ra hết thời gian chờ hoặc phản hồi result_pending_check, hãy giữ định danh ban đầu được trả về và kiểm tra thao tác đó thay vì gửi lại cảnh quay.
Đánh giá toàn bộ thời lượng của cảnh quay hoàn tất: hành động dự định, ngoại hình chủ thể, bố cục và chuyển động đều thuộc bản mô tả cảnh quay. Cấu hình chính xác này cung cấp quy trình từ văn bản sang video được mô tả ở đây. Tác vụ đã trả về mà vẫn cần kiểm tra trạng thái phải được theo dõi bằng định danh ban đầu, kể cả khi yêu cầu của máy khách hết thời gian chờ; hãy giữ thông tin tác vụ đó trước khi cân nhắc yêu cầu tạo mới.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Bắt đầu
Cấu hình kling-v1-6 tạo video từ mô tả cảnh bằng văn bản. Lên kế hoạch cho cảnh quay ngắn với chủ thể, hành động và hướng máy quay rõ ràng, dùng các lựa chọn thời lượng năm hoặc mười giây được ghi trong tài liệu. Quá trình tạo là bất đồng bộ: giữ định danh tác vụ được trả về và lấy video hoàn tất sau khi tác vụ ban đầu thành công.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Video
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Video POST /v1/videos
- Đầu vào
text- Đầu ra
video
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn kling-v1-6 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngmode | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn std, pro | Mặc định— |
Trườngmodel_name | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn kling-v1-6 | Mặc định— |
Trườngcfg_scale | Loạinumber | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 0 Tối đa: 1 | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngnegative_prompt | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 5, 10 | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt, mode |
Tham sốoptional | Hợp đồngmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngmodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
Bí danh phương thức: /v1/videos/generations
Vòng đời: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Cách tính phí cuối cùng
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí ước tính để so sánh
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Số lượng dự báo | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhEstimated generation cost | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu vào · Chi phí tạo ước tính · Ước tính chỉ để so sánh $6 ước tính trước khi tạo This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Nhận và lưu kết quả
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi video đã hoàn tất hoặc tệp trả về; truy xuất từng URL tài nguyên thực tế được trả về.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Nếu cần kiểm tra phản hồi gốc
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngdata.task_result.videos[].url | Loạistring or array, as returned |
Bí danh
Bí danh mô hình
Ailoot Ultra kling-v1-6
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · kling-v1-6
- Có những đầu vào và kết quả nào?
POST /v1/videos·kling-v1-6:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Áp dụng những giới hạn nào?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1