ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast là cấu hình Fast có tên riêng để tạo video không tiếng từ văn bản và từ ảnh. Cấu hình nhận yêu cầu cảnh hoặc bố cục dựa trên ảnh, với đầu ra 2–12 giây, tốc độ 24 fps và tùy chỉnh khuôn hình rõ rà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.
Seedance 1.0 Pro Fast là cấu hình Fast có mã doubao-seedance-1-0-pro-fast-251015. Cấu hình tạo video không tiếng từ cảnh viết bằng văn bản hoặc bố cục mở đầu dựa trên ảnh. Mã chọn cụ thể phân biệt cấu hình này với Seedance 1.0 Pro; từ Fast không quy định thời gian hoàn tất được bảo đảm cho từng tác vụ. Chọn chế độ đầu vào theo yếu tố cần xác lập cảnh, rồi đối chiếu đoạn video trả về với yêu cầu đó.
Cảnh dựa trên văn bản bắt đầu bằng một trình tự ngắn gọn: chủ thể và bối cảnh, hành động, đường di chuyển máy quay và góc nhìn cuối. Để hé lộ sản phẩm, mô tả vật trên bề mặt đặt nó, ánh sáng lướt trên chất liệu và một chuyển động ngắn kết thúc ở đặc điểm cần thể hiện. Với ý tưởng địa điểm, chuyển từ cảnh toàn giới thiệu sang điểm nhấn dễ nhận ra. Tránh bắt một đoạn video ngắn thực hiện nhiều cảnh không liên quan mà chủ thể và bối cảnh đều phải được giới thiệu lại từ đầu.
Cảnh dựa trên ảnh bắt đầu bằng mục image_url trong mảng content và chỉ dẫn chuyển động bằng văn bản. Chuẩn bị phần cắt khung, nền và cách bố trí chủ thể trong ảnh, rồi nêu các yếu tố nào chuyển động và máy quay vận hành ra sao. Điều này cho phép một bố cục tĩnh trở thành cảnh chuyển động ngắn. Cách này hữu ích cho chân dung, vật trên bàn hoặc ý tưởng hình ảnh đã chuẩn bị, nhưng vẫn cần kiểm tra kết quả thực tế về đặc điểm nhận diện, hình dạng và chuyển động xuyên suốt đoạn video.
Ảnh đầu vào có thể dùng URL truy cập được hoặc Base64 data URL. Các định dạng được ghi là JPEG, PNG, WEBP, BMP, TIFF và GIF; ảnh phải nhỏ hơn 30 MB, mỗi chiều lớn hơn 300 và nhỏ hơn 6000 pixel, tỷ lệ chiều rộng chia chiều cao lớn hơn 0.4 và nhỏ hơn 2.5. Các cận này không được lấy bằng. Chọn nguồn sạch, thấy rõ chi tiết chủ thể. Hướng dẫn ảnh khuyên dùng khuôn hình thích ứng, nên tỷ lệ nguồn đã chuẩn bị cần phù hợp với bố cục muốn làm chuyển động.
Cấu hình 1.0 ghi thời lượng từ hai đến mười hai giây ở 24 fps. Pro Fast có độ phân giải mặc định 1080p, và bảng đầu ra được lưu có các mức 480p, 720p và 1080p. Hướng dẫn thao tác loại trừ 1080p cho trường hợp dùng ảnh tham chiếu. Tỷ lệ khung cố định gồm 16:9, 4:3, 1:1, 3:4, 9:16 và 21:9. Chọn độ phân giải và dạng khung phù hợp với chế độ đầu vào đã chọn, thay vì cho rằng mọi tổ hợp có thể dùng thay nhau.
Tùy chọn seed và hình mờ giúp các thiết lập yêu cầu được nêu rõ. Khoảng seed số nguyên là từ -1 đến 2^32-1; -1 yêu cầu ngẫu nhiên. Chỉ dẫn cố định máy quay có điều kiện: hướng dẫn loại trừ nó trong trường hợp dùng ảnh tham chiếu và không bảo đảm hiệu ứng hình ảnh khi được hỗ trợ. Lệnh tham số nằm trong văn bản ghi đè các tham số tùy chọn riêng. Giữ các chỉ dẫn thống nhất, nhất là khi sửa prompt mà lệnh thời lượng hoặc độ phân giải cũ có thể vẫn còn trong mô tả cảnh.
Mức sử dụng được đo bằng token video: chiều rộng đầu ra × chiều cao đầu ra × tốc độ khung hình × thời lượng đầu ra / 1024. Tác vụ hoàn tất báo lượng này trong usage.completion_tokens. Lưu mức sử dụng được báo cùng đoạn video hoàn chỉnh và các thiết lập đã yêu cầu.
Việc gửi tạo một tác vụ bất đồng bộ. Lưu mã tác vụ, theo dõi trạng thái và lấy video hoàn chỉnh từ content.video_url sau khi thành công. Theo tài liệu, tệp được tạo được lưu trong bảy ngày, nên giữ thành phẩm cùng prompt và ảnh đầu vào nếu có. Kiểm tra toàn bộ hành động, chuyển động máy quay và khuôn hình cuối; nếu một chi tiết không đúng yêu cầu, mô tả đúng điểm cần sửa và giữ các phần đã đạt.
Ailoot Ultra · Tạo video POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Bắt đầu
Seedance 1.0 Pro Fast là cấu hình Fast có tên riêng để tạo video không tiếng từ văn bản và từ ảnh. Cấu hình nhận yêu cầu cảnh hoặc bố cục dựa trên ảnh, với đầu ra 2–12 giây, tốc độ 24 fps và tùy chỉnh khuôn hình rõ rà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 · Tạo 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 doubao-seedance-1-0-pro-fast-251015 | Mặc định— |
Trườngcontent | Loạiarray | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Các đối tượng văn bản/đa phương tiện gốc; mảng ngoài phải không rỗng. Bộ dựng tổng quát này của Ailoot không xác thực kiểu của các nút lồng nhau. | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 2 Tối đa: 12 Điều kiện: Lược đồ chính 1.x quy định 2–12; mô tả dùng chung sau đó nêu 1.5 là 4–12 hoặc -1. Ví dụ dùng 5, được cả hai tài liệu quy định. | Mặc định5 |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Các giá trị được xác nhận cho tạo video từ văn bản là 480p và 1080p. Đầu vào ảnh tham chiếu không hỗ trợ 1080p. Giá trị liệt kê 720p dùng chung mâu thuẫn với phần mô tả riêng của mô hình, nên khả năng hỗ trợ 720p vẫn chưa được xác định ở cả hai chế độ. | Mặc định1080p |
Trườngratio | 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, 21:9, adaptive Điều kiện: Giá trị mặc định tùy thuộc cảnh/mô hình; tài liệu đầu vào ảnh khuyến nghị adaptive. | Mặc định— |
Trườngservice_tier | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn default, flex Điều kiện: default=trực tuyến, flex=ngoại tuyến; chọn trước khi tạo. | Mặc địnhdefault |
Trườngseed | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn Tối thiểu: -1 Tối đa: 4.294.967.295 | Mặc định-1 |
Trườngcamerafixed | Loạiboolean | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Ailoot yêu cầu trường này; tài liệu ghi nhận điều khiển máy quay bằng ảnh tham chiếu chưa được hỗ trợ và không bảo đảm hiệu ứng. | Mặc địnhfalse |
Trườngwatermark | Loạiboolean | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc địnhfalse |
Trườngexecution_expires_after | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn Tối thiểu: 3.600 Tối đa: 259.200 Đơn vị: giây | Mặc định172.800 |
Tổ hợp tư liệu đầu vào
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 đồngcamerafixed, content, execution_expires_after, model, seed, watermark |
Tham sốoptional | Hợp đồngduration, resolution, ratio, service_tier |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốadditional_properties | Hợp đồngtrue |
Tham sốvalidation_scope | Hợp đồngAiloot kiểm tra kiểu dữ liệu của các trường bắt buộc và mảng model/content không rỗng. Các trường yêu cầu khác được giữ nguyên cho mô hình đã chọn. |
Tham sốimage_constraints | Hợp đồng{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
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/videos/generations/{request_id}/content
Tạo một lần và giữ lại id/polling_url công khai được trả về.
Thăm dò tác vụ ban đầu; tải xuống content.video_url thực tế thuộc quyền sở hữu sau trạng thái succeeded.
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 | Đơn vị tính phí | 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— | Đơn vị tính phí— | 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ìnhUltra | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Phí Đầu ra · Ước tính chỉ để so sánh $0.0012 mỗi 1K token video |
| 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 | Đơn vị tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.0576 ướ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 · Tạo video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Nhận và lưu kết quả
Ailoot Ultra · Tạo video
JSON gốc với id/polling_url công khai. Sau khi công bố, content.video_url chứa URL đã ký thuộc quyền sở hữu của Ailoot; trước khi công bố, các URL đầu ra được chọn bị xóa trống.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
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 mọi URL thực tế trong content.video_url; index phải xác định một đầu ra thực tế được trả về.
Nếu cần kiểm tra phản hồi gốc
Giữ nguyên phản hồi/tiêu đề/id ban đầu và thăm dò thao tác đó; tuyệt đối không gửi lại yêu cầu tạo chưa rõ kết quả.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngid | Loạistring |
Trườngprovider_task_id | Loạistring |
Trườngpolling_url | Loạistring |
Trườngstatus | Loạistring when supplied |
Trườngcontent.video_url | Loạistring|string[] |
Trườngusage | Loạiobject when supplied |
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ệnJSON/model/kiểu của trường bắt buộc hoặc chỉ số nội dung không hợp lệ. | Bước tiếp theo |
Phản hồi401 · authentication_error | Điều kiệnKhóa API Ailoot không hợp lệ. | Bước tiếp theo |
Phản hồi404 · not_found_error | Điều kiệnTác vụ/đầu ra không tồn tại hoặc không thuộc cùng người dùng/khóa API/nhóm. | Bước tiếp theo |
Phản hồi502 · result_pending_check | Điều kiệnLần gửi/trạng thái ban đầu chưa đầy đủ; giữ nguyên ID ban đầu, không gửi lại. | Bước tiếp theo |
Phản hồi503 · result_pending_check | Điều kiệnNội dung đa phương tiện/tuyến/quyết toán ban đầu đang được kiểm tra; tiếp tục thao tác ban đầu. | Bước tiếp theo |
Bí danh
Bí danh mô hình
Ailoot Ultra doubao-seedance-1-0-pro-fast-251015
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Có những đầu vào và kết quả nào?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Áp dụng những giới hạn nào?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200