ByteDance: Seedance 1.0 Lite Text-to-Video
Seedance 1.0 Lite Text-to-Video biến một cảnh được mô tả bằng văn bản thành video không tiếng. Mã chọn Lite cụ thể này dùng văn bản thay vì ảnh tham chiếu, với thời lượng 2–12 giây, tốc độ 24 fps và khuôn hình ngang, dọc, vuông hoặc điện ảnh.
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 Lite Text-to-Video tạo video từ một cảnh được mô tả bằng văn bản. Mã chọn cụ thể doubao-seedance-1-0-lite-t2v-250428 là thành viên tạo video từ văn bản của phiên bản Lite. Dùng mã này khi có thể mô tả trực tiếp chủ thể, bối cảnh và chuyển động: sản phẩm trên mặt bàn, cảnh toàn giới thiệu địa điểm hoặc một hành động ngắn của nhân vật. Kết quả là một đoạn video; cấu hình 1.0 không tạo âm thanh đồng bộ.
Viết cảnh theo thứ tự người xem cần nhìn thấy. Xác định chủ thể và diện mạo, địa điểm, hành động, cỡ cảnh và chuyển động máy quay, rồi mô tả bố cục cuối. Một yêu cầu sản phẩm hữu ích có thể nêu chai trên bục đá sáng màu, ánh nắng di chuyển trên nhãn và máy quay tiến chậm về phía nắp. Đây là chỉ dẫn cho một cảnh mới, không phải khẳng định rằng mô hình tái hiện ảnh sản phẩm đã cung cấp. Giữ hành động nhìn thấy phù hợp với độ dài đoạn video đã chọn.
Mã tạo video từ văn bản này khác mã Lite tạo video từ ảnh có tên riêng. Nội dung được cung cấp dưới dạng một mục văn bản trong mảng content. Câu văn có thể mô tả người, vật hoặc phong cách, nhưng không đính kèm ảnh tham chiếu hay xác lập diện mạo chính xác từ một tệp chưa được xem. Với cảnh phải lấy bố cục mở đầu từ ảnh sẵn có, hãy chọn cấu hình hỗ trợ ảnh thay vì cho rằng mã Lite t2v đổi chế độ khi thêm trường phương tiện.
Khoảng thời lượng 1.0 được tài liệu nêu là từ hai đến mười hai giây, mặc định năm giây và tốc độ khung hình cố định 24 fps. Lite có các mức độ phân giải 480p, 720p và 1080p; mặc định được ghi là 720p. Các tỷ lệ khung hình cố định gồm 16:9, 4:3, 1:1, 3:4, 9:16 và 21:9. Chọn khung hình theo nơi sử dụng trước khi tạo: dọc cho nội dung trình bày theo chiều dọc, vuông cho ô sản phẩm gọn hoặc ngang cho cảnh rộng. Mức độ phân giải và tỷ lệ khung hình mô tả đầu ra được yêu cầu; hãy kiểm tra kích thước pixel và khuôn hình thực tế của đoạn video tải xuống.
Yêu cầu có các tùy chỉnh seed, hình mờ và máy quay. seed là số nguyên từ -1 đến 2^32-1, trong đó -1 chọn ngẫu nhiên. Yêu cầu cố định máy quay thêm một chỉ dẫn giữ máy quay cố định; tài liệu nói rõ hiệu ứng này không được bảo đảm. Giữ hướng máy quay nhất quán giữa cảnh viết bằng văn bản và tùy chỉnh riêng. Chỉ dẫn tham số nằm trong văn bản được ưu tiên hơn các tham số tùy chọn riêng, nên tránh đưa chỉ dẫn thời lượng, độ phân giải hoặc khuôn hình mâu thuẫn ở hai nơi.
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.
Quá trình tạo diễn ra bất đồng bộ. Khi gửi, hệ thống trả mã tác vụ; truy vấn tác vụ cung cấp trạng thái xử lý và, sau khi thành công, URL video trong content.video_url. Giữ mã tác vụ khi công việc ở trạng thái queued hoặc running, rồi lưu đoạn video hoàn chỉnh cho lần sửa tiếp theo. Thời gian lưu tệp được tạo theo tài liệu là bảy ngày. Yêu cầu còn có khoảng hết hạn tính từ lúc tạo tác vụ, sau đó tác vụ chưa hoàn tất chuyển thành expired; mặc định được ghi là 172800 giây, với giá trị từ 3600 đến 259200 giây.
Đối chiếu toàn bộ đoạn video với yêu cầu: chủ thể mong muốn có xuất hiện không, hành động có đúng thứ tự không, máy quay có theo hướng đã yêu cầu không và khung hình cuối có dùng được không. Sửa một chỉ dẫn cụ thể cho phiên bản tiếp theo, đồng thời giữ cấu trúc cảnh đã thành công. Với chuỗi cảnh quay, lưu từng prompt, thiết lập đã yêu cầu và video hoàn chỉnh để lập kế hoạch cảnh sau dựa trên kết quả thực tế.
Ailoot Ultra · Tạo video POST /v1/videos doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428
doubao-seedance-1-0-lite-t2v-250428Bắt đầu
Seedance 1.0 Lite Text-to-Video biến một cảnh được mô tả bằng văn bản thành video không tiếng. Mã chọn Lite cụ thể này dùng văn bản thay vì ảnh tham chiếu, với thời lượng 2–12 giây, tốc độ 24 fps và khuôn hình ngang, dọc, vuông hoặc điện ảnh.
- Đầ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 · Tạo 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 doubao-seedance-1-0-lite-t2v-250428 | 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 480p, 720p, 1080p Điều kiện: Tập giá trị liệt kê dùng chung; 1080p không hỗ trợ với ảnh tham chiếu và 1.5. Mô tả pro nội tuyến liệt kê 480p/1080p trong khi tập giá trị cấp cao nhất có 720p; chưa có kết luận bảo đảm pro hỗ trợ 720p. | Mặc định720p |
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 |
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. |
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.003 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.144 ướ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-lite-t2v-250428","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-lite-t2v-250428
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · ByteDance: Seedance 1.0 Lite Text-to-Video
- Có những đầu vào và kết quả nào?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·doubao-seedance-1-0-lite-t2v-250428: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-lite-t2v-250428:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200