ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro tạo video không tiếng từ văn bản hoặc ảnh mở đầu. Mô tả hành động và máy quay, hoặc làm chuyển động một bố cục sẵn có, với thời lượng 2–12 giây, tốc độ 24 fps cùng tùy chỉnh rõ ràng về khuôn hình và độ phân giải đầu ra.

Ailoot Ultra · Tạo video POST /v1/videos doubao-seedance-1-0-pro-250528

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 tạo video từ văn bản hoặc một cảnh có ảnh dẫn hướng. Mã chọn doubao-seedance-1-0-pro-250528 hỗ trợ cả hai chế độ đầu vào, nên điểm khởi đầu có thể là ý tưởng bằng văn bản hoặc bố cục hình ảnh sẵn có. Dùng yêu cầu bằng văn bản để tạo cảnh mới, hoặc cung cấp ảnh khi cần xác lập chủ thể, cách sắp xếp và góc nhìn mở đầu bằng hình ảnh. Cấu hình 1.0 này tạo video không tiếng; âm thanh đồng bộ thuộc cấu hình 1.5 Pro được mô tả riêng.

Để tạo video từ văn bản, nêu chủ thể, môi trường, chuyển động, khuôn hình và máy quay trong một cảnh thống nhất. Ví dụ trong tài liệu chuyển dần từ cánh đồng hoa cúc sang cận cảnh một bông hoa có sương trên cánh. Cấu trúc này hữu ích cho các cảnh hé lộ khác: giới thiệu bối cảnh, tiến về chủ thể và kết thúc ở chi tiết quan trọng. Với ý tưởng sản phẩm, mô tả chất liệu và ánh sáng cùng hành động, đồng thời cho máy quay một đường di chuyển khả thi trong cảnh ngắn.

Để tạo video từ ảnh, đặt tham chiếu trong một mục nội dung image_url và giải thích điều cần thay đổi từ góc nhìn ban đầu đó. Ảnh chân dung đã chuẩn bị có thể xác lập người và phần cắt khung, còn yêu cầu mô tả cú quay nhẹ, tóc chuyển động hoặc máy quay lùi nhẹ. Ảnh tĩnh sản phẩm có thể xác lập vật và nền, còn prompt yêu cầu một chuyển động hé lộ có kiểm soát. Giữ chuyển động được yêu cầu phù hợp với bố cục nguồn; ảnh một mặt của vật không cung cấp góc nhìn chính xác về mọi mặt còn lại chưa được thể hiện.

Trường ảnh chấp nhận URL truy cập được hoặc data URL chứa dữ liệu ảnh Base64. Các định dạng được ghi là JPEG, PNG, WEBP, BMP, TIFF và GIF. Ảnh phải nhỏ hơn 30 MB, có tỷ lệ rộng/cao lớn hơn 0.4 và nhỏ hơn 2.5, mỗi chiều lớn hơn 300 và nhỏ hơn 6000 pixel. Chuẩn bị nguồn rõ nét với phần cắt khung mong muốn thay vì dựa vào ảnh thu nhỏ vốn đã thiếu các chi tiết nhận diện. Khi tạo video từ ảnh, hướng dẫn khuyên dùng khuôn hình thích ứng để theo tỷ lệ của ảnh tham chiếu.

Thời lượng 1.0 được ghi là từ hai đến mười hai giây, tốc độ khung hình 24 fps. Tùy chỉnh đầu ra có các mức 480p, 720p và 1080p, với 1080p là mặc định của Pro; hướng dẫn loại trừ 1080p trong trường hợp dùng ảnh tham chiếu. Các dạng khung cố định gồm 16:9, 4:3, 1:1, 3:4, 9:16 và 21:9. Chọn tổ hợp tương thích với ảnh cho cảnh lấy ảnh làm đầu vào, thay vì chuyển nguyên mọi thiết lập tạo video từ văn bản sang. Kiểm tra khuôn hình thực tế được trả về trước khi đưa đoạn video vào bố cục trình bày.

Các tùy chỉnh seed và hình mờ được ghi cùng camerafixed. Chỉ dẫn cố định máy quay không được hỗ trợ trong trường hợp dùng ảnh tham chiếu; khi có thể áp dụng, hướng dẫn cũng không bảo đảm máy quay đứng yên hoàn toàn. Chỉ dẫn tham số nằm trong prompt được ưu tiên hơn các trường tùy chọn riêng. Giữ một thiết lập làm chuẩn cho thời lượng, độ phân giải và tỷ lệ, đồng thời cho mô tả máy quay thống nhất với thiết lập đó. Nhờ vậy yêu cầu cảnh không âm thầm ghi đè các thiết lập đã chọn cho yêu cầu.

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.

Quy trình trả mã tác vụ trước, rồi trả vị trí video hoàn chỉnh sau khi xử lý. Giữ mã khi kiểm tra trạng thái queued hoặc running; tác vụ succeeded cung cấp content.video_url và thông tin sử dụng. Thời gian lưu tệp được tạo theo tài liệu là bảy ngày. Lưu đoạn video hoàn chỉnh, ảnh nguồn và prompt chính xác làm hồ sơ chỉnh sửa, rồi kiểm tra diện mạo chủ thể, chuyển động, tính liên tục của hình ảnh và bố cục kết thúc trên toàn bộ kết quả.

Ailoot Ultra · Tạo video POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

Bắt đầu

Đầ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ường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn doubao-seedance-1-0-pro-250528	Mặc định—
Trường`content`	Loại`array`	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ường`duration`	Loại`integer`	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ường`resolution`	Loại`string`	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ường`ratio`	Loại`string`	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ường`service_tier`	Loại`string`	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ường`seed`	Loại`integer`	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ường`camerafixed`	Loại`boolean`	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ường`watermark`	Loại`boolean`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc địnhfalse
Trường`execution_expires_after`	Loại`integer`	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.0044 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.2112 ướ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

curl · tạo videocurl · đọc tác vụ gốccurl · tải xuống video thuộc quyền sở hữu của bạn

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","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}/content
GET /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ường`id`	Loạistring
Trường`provider_task_id`	Loạistring
Trường`polling_url`	Loạistring
Trường`status`	Loạistring when supplied
Trường`content.video_url`	Loạistring\|string[]
Trường`usage`	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-250528

Bí danh đường dẫn phương thức

/v1/videos/generations

ID gọi liên quan

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

Có những đầu vào và kết quả nào?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
Yêu cầu sử dụng những trường nào?: POST /v1/videos · doubao-seedance-1-0-pro-250528: 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-250528: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 1.0 Pro