PixVerse v5
PixVerse v5 tạo video ngắn từ văn bản hoặc ảnh. Dùng bản mô tả hành động cụ thể, ảnh tham chiếu đã chuẩn bị khi cần và các điều khiển bố trí khung hình, độ phân giải trong tài liệu để phát triển một cảnh có phần kết hữu ích.
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.
PixVerse v5 là mô hình video dùng để chuyển văn bản thành video và chuyển ảnh thành video. Bản mô tả yêu cầu bằng văn bản xác lập sự việc, còn ảnh tham chiếu tùy chọn cung cấp diện mạo và bố cục ban đầu. Dùng mỗi cảnh quay được tạo cho một mục đích xác định, chẳng hạn giới thiệu chủ thể, thể hiện cử chỉ hoặc hé lộ một chi tiết hình ảnh.
Mô tả hành động bằng những yếu tố có thể quan sát. Một bàn tay mở hộp, một người băng qua sân hoặc một vật thể di chuyển vào vùng sáng đều tạo ra thay đổi có thể nhận diện cho chuỗi hình ảnh. Nêu chủ thể nào chuyển động, những gì bao quanh chủ thể và sự việc cần kết thúc như thế nào. Giữ các chi tiết giúp nhận diện cảnh.
Khi tạo dựa trên ảnh, chọn ảnh tham chiếu đã phù hợp với bố cục dự kiến. Giữ các đặc điểm nhận diện dễ nhìn thấy và chừa khoảng trống cho chuyển động được yêu cầu. Giải thích cảnh phát triển như thế nào từ ảnh đó. Lưu nguồn cùng video hoàn chỉnh để có thể đánh giá tính liên tục thông qua đối chiếu trực tiếp.
Danh mục mô hình trong tài liệu liệt kê nhiều dạng khung hình và lựa chọn độ phân giải, với tùy chọn thời lượng 5 và 8 giây. Chọn tổ hợp mà quy trình cung cấp và ghi lại giá trị thực tế của nó. Lên kế hoạch hành động và phần kết theo độ dài cảnh quay đã chọn và khung hình sử dụng cuối cùng.
Dùng chỉ dẫn máy quay để hướng sự chú ý. Góc nhìn cố định có thể nhấn mạnh hành động của chủ thể, còn góc nhìn chuyển động có thể hé lộ bối cảnh hoặc chi tiết. Giải thích mối quan hệ của máy quay với chủ thể để chuyển động phục vụ cảnh. Kiểm tra phần kết để xem thông tin mong muốn có còn nhìn thấy được hay không.
Với loạt cảnh quay có liên quan, giữ mô tả chủ thể và bối cảnh lặp lại nhất quán trong các bản yêu cầu tương ứng. Lưu từng ảnh tham chiếu và mô hình đã chọn cùng kết quả. Ghép các đoạn video hoàn chỉnh theo thứ tự dự kiến và kiểm tra những thay đổi về diện mạo, ánh sáng và quan hệ không gian xuyên suốt bản dựng.
Xem lại toàn bộ từng video về hành động được yêu cầu, tính liên tục và nhịp thời gian. Quan sát bàn tay, khuôn mặt, đường nét vật thể và chi tiết chất liệu khi chúng quan trọng đối với cảnh. Kiểm tra những thời điểm các chủ thể che khuất nhau hoặc di chuyển sang góc nhìn khác. Một cảnh quay hữu ích không chỉ dễ theo dõi ở khung hình tĩnh đẹp nhất mà còn ở những thời điểm khác trong đoạn video.
Lưu video hoàn chỉnh cùng câu lệnh, ảnh nguồn và thiết lập. Khi một phương án cần chỉnh sửa, xác định điểm sai lệch cụ thể và thay đổi chỉ dẫn liên quan. Giữ ổn định các lựa chọn bố cục và diện mạo đã đạt yêu cầu để có thể so sánh kết quả tiếp theo theo cùng mục tiêu hình ảnh.
Ailoot Ultra · Video POST /v1/videos pixverse-v5
pixverse-v5Bắt đầu
PixVerse v5 tạo video ngắn từ văn bản hoặc ảnh. Dùng bản mô tả hành động cụ thể, ảnh tham chiếu đã chuẩn bị khi cần và các điều khiển bố trí khung hình, độ phân giải trong tài liệu để phát triển một cảnh có phần kết hữu ích.
- Đầ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 pixverse-v5 Đ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 Điều kiện: Mô tả cảnh và chuyển động trong cảnh. | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 16:9, 4:3, 1:1, 3:4, 9:16 Điều kiện: Dùng một tỷ lệ khung hình được liệt kê cho mô hình đã chọn. | Mặc định— |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 360p, 540p, 720p, 1080p Điều kiện: Dùng giá trị chất lượng được liệt kê cho mô hình đã chọn. | Mặc định— |
Trườngmotion_mode | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn normal, fast Điều kiện: Dùng chế độ chuyển động được liệt kê cho mô hình đã chọn. | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 5, 8 Điều kiện: Dùng một thời lượng được liệt kê; không tự suy ra giá trị mặc định chưa được nêu. | 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: Khung hình kết thúc tùy chọn sẽ chọn một chế độ hình ảnh được hỗ trợ. | Mặc định— |
Trườnglip_sync_tts_content | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Nội dung lời nói tùy chọn cho mô hình đã chọn. | Mặc định— |
Trườnglip_sync_tts_speaker_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng ID giọng nói thực tế được nhà cung cấp hỗ trợ; không tự đặt ID giọng nói. | Mặc định— |
Trườngimage | Loạistring or array<string> | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng URL hình ảnh thực tế của bạn có thể truy cập công khai hoặc hình ảnh base64; mô hình đã chọn hỗ trợ đầu vào hình ảnh. | 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: Mô tả nội dung cần trá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 |
Tham sốoptional | Hợp đồngaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, 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., Mô tả cảnh và chuyển động trong cảnh., Dùng một tỷ lệ khung hình được liệt kê cho mô hình đã chọn., Dùng giá trị chất lượng được liệt kê cho mô hình đã chọn., Dùng chế độ chuyển động được liệt kê cho mô hình đã chọn., Dùng một thời lượng được liệt kê; không tự suy ra giá trị mặc định chưa được nêu., Khung hình kết thúc tùy chọn sẽ chọn một chế độ hình ảnh được hỗ trợ., Nội dung lời nói tùy chọn cho mô hình đã chọn., Dùng ID giọng nói thực tế được nhà cung cấp hỗ trợ; không tự đặt ID giọng nói., Dùng URL hình ảnh thực tế của bạn có thể truy cập công khai hoặc hình ảnh base64; mô hình đã chọn hỗ trợ đầu vào hình ảnh., Mô tả nội dung cần trá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 $0.2 ướ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}"
cat > request.json <<'JSON'
{
"model": "pixverse-v5",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every 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 |
Bí danh
Bí danh mô hình
Ailoot Ultra pixverse-v5
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · PixVerse v5
- Có những đầu vào và kết quả nào?
POST /v1/videos·pixverse-v5:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·pixverse-v5:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt