Kling v2.1 Master
Kling v2.1 Master tạo video từ văn bản hoặc bản mô tả yêu cầu dựa trên ảnh. Dùng mô hình để thể hiện một sự việc cụ thể bằng hình ảnh, với chủ thể, hành động, chỉ dẫn máy quay và phần kết được lên kế hoạch thành một cảnh quay ngắn mạch lạc.
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.
Kling v2.1 Master là một phiên bản video của Kling, có khả năng chuyển văn bản thành video và chuyển ảnh thành video theo danh mục mô hình trong tài liệu. Chọn bản mô tả cảnh bằng văn bản khi phát triển ý tưởng hình ảnh từ văn bản, hoặc bản mô tả dựa trên ảnh khi chủ thể và bố cục đã được xác lập. Trong cả hai trường hợp, hãy xác định sự việc mà cảnh quay hoàn chỉnh cần thể hiện.
Khi tạo từ văn bản, mô tả chủ thể, bối cảnh và hành động theo thứ tự rõ ràng. Một vũ công băng qua phòng tập, một chiếc xe chạy dưới những tán cây hoặc một vật bằng thủy tinh đón ánh sáng thay đổi đều tạo ra mục đích cụ thể cho chuỗi hình ảnh. Nêu các chi tiết quyết định diện mạo của cảnh và giữ chúng nhất quán trong toàn bộ bản mô tả.
Khi tạo dựa trên ảnh, chuẩn bị ảnh tham chiếu thể hiện các đặc điểm mà cảnh quay cần giữ lại. Giữ khuôn mặt, cạnh vật thể và các chất liệu đặc trưng dễ nhìn thấy. Mô tả những gì thay đổi từ góc nhìn ban đầu đó: cử chỉ của chủ thể, chuyển động trong môi trường hoặc vị trí máy quay. Giữ ảnh nguồn sẵn để đối chiếu khi xem lại kết quả.
Lên kế hoạch hành động dựa trên trạng thái kết thúc. Một người đặt vật thể xuống cần kết thúc với vật thể ở vị trí có thể xác định được; cảnh hé lộ cần kết thúc khi đặc điểm quan trọng đã nhìn thấy rõ. Điều này giúp dễ chọn điểm cắt và đánh giá xem chuyển động có hoàn thành mục đích của nó hay không.
Mục mô hình trong tài liệu bao gồm thời lượng 5 và 10 giây, chế độ std và pro, cùng dạng khung hình ngang, dọc và vuông. Chọn các điều khiển có sẵn trong quy trình đã chọn và lưu giá trị thực tế của chúng. Đánh giá đoạn video kết quả theo hành động và cách bố trí khung hình mong muốn thay vì dựa vào tên phiên bản của mô hình.
Mô tả chuyển động của chủ thể và máy quay riêng biệt. Với cảnh quay bám theo, hãy nêu chủ thể mà máy quay theo dõi và những phần môi trường cần đi qua khung hình. Với cảnh quay cố định, hãy nêu chuyển động diễn ra bên trong khung. Gắn chỉ dẫn máy quay với điều mà người xem cần chú ý.
Kiểm tra tính liên tục của toàn bộ chuỗi hình ảnh. Xác nhận chủ thể quan trọng vẫn có thể nhận diện, các tương tác hợp lý về không gian và nhịp thời gian chừa đủ khoảng cho điểm cắt dự kiến. Quan sát những thay đổi ở bàn tay, khuôn mặt, chi tiết bề mặt và các vật thể che khuất nhau. Đánh giá chuyển động cùng với khung hình riêng lẻ đẹp nhất.
Lưu từng video hoàn chỉnh cùng câu lệnh, ảnh tham chiếu và thiết lập của nó. Dùng cùng một bản mô tả khi so sánh một cảnh giữa các phiên bản và ghi lại những khác biệt hình ảnh thực tế. Khi sửa một phương án, mô tả vấn đề quan sát được và chỉnh chỉ dẫn liên quan, đồng thời giữ lại các yếu tố hữu ích của cảnh.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterBắt đầu
Kling v2.1 Master tạo video từ văn bản hoặc bản mô tả yêu cầu dựa trên ảnh. Dùng mô hình để thể hiện một sự việc cụ thể bằng hình ảnh, với chủ thể, hành động, chỉ dẫn máy quay và phần kết được lên kế hoạch thành một cảnh quay ngắn mạch lạc.
- Đầ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-v2-1-master Điều kiện: Dùng chính xác bộ chọn định tuyến Ailoot này. | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối đa: 500 Điều kiện: | Mặc định— |
Trườngmode | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn std, pro Điều kiện: | Mặc định— |
Trườngmodel_name | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Tùy chọn ghi đè thiết lập gốc của mô hình. Bỏ qua để tự động dùng mô hình đã chọn; giá trị được chỉ định rõ sẽ được giữ nguyên. | 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 Điều kiện: | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: | Mặc định— |
Trườngnegative_prompt | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Độ dài tối đa: 200 Điều kiệ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 Điều kiện: | 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 đồngDùng chính xác bộ chọn định tuyến Ailoot này., Tùy chọn ghi đè thiết lập gốc của mô hình. Bỏ qua để tự động dùng mô hình đã chọn; giá trị được chỉ định rõ sẽ được giữ nguyên. |
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ìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $6 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
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-v2-1-master", "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.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
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ề.
Giữ lại toàn bộ phản hồi và tiêu đề, các mã định danh gốc, mọi đầu ra thực tế và tất cả trường mức sử dụng/hạch toán. Lưu từng tài sản duy nhất thuộc quyền sở hữu và giữ lại mọi vai trò tham chiếu đến tài sản đó.
Nếu cần kiểm tra phản hồi gốc
Giữ lại id tác vụ hoặc thao tác công khai được trả về và tất cả tiêu đề. Chỉ đọc tác vụ ban đầu; unknown hoặc result_pending_check không cho phép tạo thêm tác vụ.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngid | Loạistring |
Trườngpolling_url | Loạistring |
Trườngprovider_task_id | Loạistring |
Trườngdata.task_id | Loạistring |
Trườngdata.task_status | Loạistring |
Trườngdata.task_result.videos[].url | Loạistring |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, bộ chọn mô hình, kiểu dữ liệu hoặc cách biểu diễn đầu vào không hợp lệ. | Bước tiếp theoXem chi tiết kết quả kiểm tra tính hợp lệ được trả về trước khi chuẩn bị một yêu cầu riêng. |
Phản hồi | Điều kiệnYêu cầu hoặc kết quả gốc chưa xác định hoặc cần kiểm tra. | Bước tiếp theoGiữ nguyên các mã định danh và trường tiêu đề gốc; chỉ đọc các bản ghi trạng thái/thư viện được hỗ trợ. Không gửi lại yêu cầu tạo. |
Bí danh
Bí danh mô hình
Ailoot Ultra kling-v2-1-master
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · Kling v2.1 Master
- Có những đầu vào và kết quả nào?
POST /v1/videos·kling-v2-1-master:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·kling-v2-1-master: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-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200