Kling v1.5
Kling v1.5 là mô hình video có quy trình chuyển ảnh thành video được nêu trong tài liệu. Bắt đầu từ một ảnh tĩnh đã chuẩn bị và mô tả chuyển động, góc nhìn cùng bố cục cuối cùng cho một cảnh quay ngắn về nhân vật, vật thể hoặc môi trườ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.
Kling v1.5 là một phiên bản tạo video của Kling, có khả năng chuyển ảnh thành video theo danh mục mô hình trong tài liệu. Ảnh tĩnh được cung cấp đóng vai trò điểm khởi đầu về hình ảnh, còn bản mô tả yêu cầu bằng văn bản giải thích cảnh cần chuyển động như thế nào. Dùng mô hình để phát triển một cử chỉ nhân vật, một vật thể chuyển động hoặc một môi trường biến đổi từ ảnh có bố cục đã phù hợp với cảnh quay.
Chuẩn bị ảnh sao cho các chi tiết quan trọng của chủ thể được thể hiện rõ. Với nhân vật, cần nhìn rõ khuôn mặt, tư thế và trang phục; với vật thể, cần có đường nét rõ ràng và các đặc điểm chất liệu dễ thấy. Chừa khoảng trống trong bố cục cho chuyển động dự kiến. Lưu ảnh tĩnh gốc cùng chuỗi hình ảnh hoàn chỉnh để có thể đánh giá trực tiếp những thay đổi về diện mạo.
Viết hành động dưới dạng một sự việc có thể quan sát. Ví dụ, mô tả một người đang ngồi quay về phía cửa sổ hoặc một dải ruy băng bằng vải chuyển động trong làn gió nhẹ. Nêu hướng chuyển động và trạng thái kết thúc mong muốn. Khi có nhiều vật thể xuất hiện, hãy xác định vật thể nào chuyển động và những vật thể nào giữ nguyên vị trí.
Giải thích vai trò của máy quay. Góc nhìn cố định giúp dễ kiểm tra một cử chỉ nhỏ, còn góc nhìn chuyển động có thể cho thấy một mặt mới của cảnh. Mô tả chuyển động đó trong mối quan hệ với chủ thể. Yêu cầu máy quay tiến gần chủ thể và yêu cầu chủ thể tiến gần máy quay thể hiện hai ý đồ hình ảnh khác nhau.
Mục chuyển ảnh thành video trong tài liệu liệt kê các lựa chọn thời lượng 5 và 10 giây, chế độ std và pro, cùng khung hình ngang, dọc và vuông. Chọn các thiết lập mà quy trình đã chọn cung cấp trước khi đánh giá kết quả. Khi so sánh các phương án cảnh quay, hãy lưu chế độ, thời lượng và dạng khung hình thực tế cùng ảnh nguồn và câu lệnh.
Với cảnh giới thiệu vật thể, hãy xác định đặc điểm hình ảnh mà chuyển động cần làm lộ rõ. Đó có thể là một bề mặt phản chiếu, nếp gấp của chất liệu hoặc hình dáng tay cầm. Giữ hành động đủ tập trung để đặc điểm quan trọng luôn nhìn thấy được. Đánh giá vật thể trong suốt chuyển động và ở góc nhìn cuối cùng được sử dụng trong bản dựng.
Với cảnh nhân vật, hãy mô tả một cử chỉ có ý nghĩa và mối quan hệ của nhân vật với các vật thể gần đó. Xem lại khuôn mặt, bàn tay, trang phục và tỷ lệ cơ thể theo thời gian. Kiểm tra xem cử chỉ có đạt đến trạng thái kết thúc dự kiến hay không và cảnh có duy trì cách sắp xếp nhất quán giữa các yếu tố tiền cảnh và hậu cảnh hay không.
Giữ lại toàn bộ đoạn video được tạo cùng các tài liệu nguồn. Xem phần mở đầu, hành động chính và phần kết như một chuỗi thống nhất, sau đó chỉnh sửa dựa trên một điểm sai lệch cụ thể. Ghi chú như “nhân vật quay đi, không còn hướng về cửa sổ” tạo ra một yêu cầu sửa rõ ràng cho bản mô tả tiếp theo, đồng thời giữ nguyên phần còn lại của cảnh.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Bắt đầu
Kling v1.5 là mô hình video có quy trình chuyển ảnh thành video được nêu trong tài liệu. Bắt đầu từ một ảnh tĩnh đã chuẩn bị và mô tả chuyển động, góc nhìn cùng bố cục cuối cùng cho một cảnh quay ngắn về nhân vật, vật thể hoặc môi trường.
- Đầu vào được chấp nhận
- Văn bản · Ảnh
- 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,image- Đầ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-5 Điều kiện: Dùng chính xác bộ chọn định tuyến Ailoot này. | Mặc định— |
Trườngmode | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn std, pro Điều kiện: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | Mặc địnhstd |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 16:9, 9:16, 1:1 Điều kiện: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | 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: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | Mặc định— |
Trườngend_image | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | Mặc định— |
Trườngimage | Loạistring or array<string> | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Cung cấp URL hình ảnh thực tế của bạn có thể truy cập được. Danh sách chỉ được chấp nhận khi lược đồ tham số quy định kiểu mảng. | Mặc định— |
Trườngnegative_prompt | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. | 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, image |
Tham sốoptional | Hợp đồngmode, aspect_ratio, duration, end_image, negative_prompt |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốconditions | Hợp đồngDùng chính xác bộ chọn định tuyến Ailoot này., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định., Cung cấp URL hình ảnh thực tế của bạn có thể truy cập được. Danh sách chỉ được chấp nhận khi lược đồ tham số quy định kiểu mảng., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định., Dùng trường được tài liệu mô tả và các lựa chọn được liệt kê cho mô hình đã chọn; bỏ qua giá trị tùy chọn chưa được chỉ định. |
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
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-5", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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ườngtask_id | Loạistring |
Trườngstatus | Loạistring |
Trườngvideo_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-v1-5
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · Kling v1.5
- Có những đầu vào và kết quả nào?
POST /v1/videos·kling-v1-5:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt