ByteDance: Seedance 2.0
ByteDance Seedance 2.0 kết hợp tạo âm thanh–video trực tiếp với tham chiếu hình ảnh, video và âm thanh. Chỉ đạo cảnh mới, chỉnh sửa cảnh quay có sẵn hoặc kéo dài một chuỗi; phiên bản tiêu chuẩn có đầu ra 1080p và 4K 10-bit được mô tả.
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 2.0 là mô hình tiêu chuẩn của ByteDance Seed cho sáng tạo âm thanh–video đa phương thức. Mô hình kết hợp văn bản, ảnh, video và âm thanh trong kiến trúc tạo chung, với các quy trình sáng tạo riêng cho cảnh dựa trên tham chiếu, chỉnh sửa và kéo dài video. Mô hình hữu ích khi yêu cầu cần cả diễn xuất mạch lạc lẫn thông tin hình ảnh hoặc âm thanh cụ thể từ tư liệu đã chuẩn bị.
Tham chiếu đa phương thức và điều khiển đạo diễn
Ảnh có thể xác định diện mạo chủ thể, phong cách hình ảnh và bố cục. Video tham chiếu có thể hướng dẫn hành động, chuyển động máy quay và hiệu ứng. Âm thanh có thể hướng dẫn âm sắc giọng, nhạc hoặc hội thoại. Xác định vai trò của từng tư liệu rồi mô tả cảnh cần thu được. Nhà sản xuất nhấn mạnh khả năng điều khiển diễn xuất, ánh sáng, bóng và ngôn ngữ máy quay.
Với câu chuyện sản phẩm, chuẩn bị ảnh sản phẩm, tham chiếu chuyển động máy quay và chỉ dẫn âm thanh. Yêu cầu có thể là: “Giữ bình thủy tinh xanh trong Image 1. Dùng chuyển động máy quay ngang chậm của Video 1. Bình đặt trên kệ có nắng, với nhạc không lời nhẹ dựa trên Audio 1.” Đầu ra dự kiến là cảnh được dàn dựng mới kết hợp thông tin tham chiếu đã chọn.
Đầu vào tham chiếu có thể kết hợp ảnh và âm thanh, ảnh và video, video và âm thanh hoặc cả ba. Chỉ âm thanh và văn bản cộng âm thanh mà không có ảnh hay video không được hỗ trợ. Chuyển văn bản thành video truyền thống, tạo từ khung đầu và tạo từ khung đầu–cuối cũng được mô tả. Nếu bố cục mở đầu và kết thúc cố định quan trọng, dùng quy trình biên chuyên biệt: gọi ảnh tham chiếu là điểm biên trong lời nhắc omni chỉ hướng dẫn gián tiếp.
Chỉnh sửa cảnh quay
Mô hình có thể thay chủ thể, thêm hoặc xóa vật, đổi yếu tố và vẽ lại hoặc sửa chữa các phần video. Mô tả thay đổi cụ thể và xác định cảnh nguồn. Với bổ sung, gồm thời điểm và vị trí xuất hiện; với xóa hoặc thay, nêu chính xác vật và nội dung cần giữ.
Ví dụ: “Thay đèn bàn trong Video 1 bằng đèn đồng thau trong Image 1. Giữ chuyển động máy quay, cách sắp xếp bàn và hướng ánh sáng.” Kết quả mong muốn là bản chỉnh sửa cảnh với sự thay thế dự kiến. Kiểm tra cả những vùng không thay đổi lẫn vật mới, đặc biệt qua che khuất, chuyển động và đổi cú máy.
Kéo dài và kết nối một chuỗi
Seedance 2.0 có thể kéo dài video về trước hoặc sau theo thời gian và nối đến ba đoạn được cung cấp bằng chuyển cảnh được tạo. Chỉ định hướng thời gian và sự kiện mới. Với đoạn nối, sắp xếp các đoạn và mô tả chuyển cảnh giữa từng cặp, chẳng hạn máy quay đi qua cửa trong một cú rồi đến môi trường tiếp theo.
Kéo dài đơn giản thường trả phần tiếp nối phát triển quanh cảnh nguồn; thêm chỉ dẫn rõ nếu kết quả cuối cũng cần lặp đoạn gốc. Khi hoàn tất kết nối giữa hai hoặc ba đoạn, quy trình được mô tả có thể gồm cả tư liệu gốc và nội dung chuyển cảnh mới. Cách này hữu ích để phát triển mở đầu hoặc kết thúc, hay nối các cảnh đã chuẩn bị mà không bỏ ngỏ hành động nối.
Đầu ra phiên bản tiêu chuẩn và 4K
Phiên bản tiêu chuẩn mô tả MP4 ở 24 fps và thời lượng từ 4 đến 15 giây. Các mức đầu ra là 480p, 720p và 1080p với độ sâu màu 8-bit, cùng 4K với độ sâu màu 10-bit. Các tỷ lệ hỗ trợ là 21:9, 16:9, 4:3, 1:1, 3:4 và 9:16. Điều chỉnh bố cục thích ứng và tự động chọn thời lượng cũng được mô tả. Phiên bản Fast có đặc tả đầu ra hẹp hơn riêng ở 480p/720p.
Đầu ra 4K dùng mã hóa H.265/HEVC. Mã hóa mười bit giữ thêm các cấp độ sắc và chuyển màu mượt hơn, hữu ích cho tư liệu có ánh sáng tinh tế hoặc chuyển sắc màu. Kiểm tra môi trường phát và biên tập dự kiến có thể giải mã định dạng đó; một số trình duyệt và thiết bị không phát trực tiếp. Định dạng chứa tương thích tự nó không bảo đảm giải mã video tương thích.
Mô hình có thể tạo âm thanh đồng bộ hoặc video im lặng, và có thể trả khung cuối đã tạo cho cảnh tiếp theo. Âm thanh được tạo là đơn âm. Họ 2.0 không hỗ trợ chế độ xem trước Draft hai giai đoạn riêng, vì vậy không suy ra tính năng xem trước đó từ phiên bản Seedance khác.
Chuẩn bị tham chiếu và giới hạn thực chất
Sức chứa tham chiếu được mô tả là đến chín ảnh, ba video và ba đoạn âm thanh. Tải trực tiếp ảnh hoặc video tham chiếu chứa khuôn mặt người thật không được chấp nhận trong cấu hình nhà sản xuất này; nội dung chân dung dùng quy trình tài sản chân dung được hỗ trợ. Mỗi video và đoạn âm thanh phải dài 2–15 giây. Tất cả video tham chiếu phải nằm trong 15 giây, và tất cả âm thanh tham chiếu có tổng riêng 15 giây. Video dùng MP4 hoặc MOV ở 24–60 fps, tối đa 200 MB mỗi tệp; âm thanh dùng WAV hoặc MP3, tối đa 15 MB mỗi tệp. Các định dạng ảnh liệt kê là JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC và HEIF. Mỗi ảnh phải nhỏ hơn 30 MB và thân yêu cầu không vượt 64 MB. Trong cấu hình đầu vào tham chiếu được mô tả, chiều rộng và cao ảnh đều phải lớn hơn 300, nhỏ hơn 6,000 pixel, với tỷ lệ rộng/cao lớn hơn 0.4, nhỏ hơn 2.5. Video tham chiếu cho phép 300–6,000 pixel mỗi chiều và tỷ lệ 0.4–2.5, tính cả biên, với tổng 407,696–8,295,044 pixel. Video MP4 hoặc MOV dùng video H.264/AVC hoặc H.265/HEVC và âm thanh AAC hoặc MP3.
Sắp xếp tệp có chủ đích và tham chiếu từng tệp bằng loại phương tiện và số: Image 1, Video 1 và Audio 1. Số theo thứ tự trong các tệp cùng loại. Giải thích đặc tính cần chuyển và nội dung nguồn không nên quyết định cảnh mới. Ngôn ngữ lời nhắc được mô tả gồm tiếng Anh, Tây Ban Nha, Indonesia, Bồ Đào Nha và Nhật. Giữ ngôn ngữ nói nhất quán trong hội thoại; hướng dẫn khuyên không trộn ngôn ngữ trừ tên riêng. Với nội dung hướng dẫn bằng giọng, tách người nói, câu chính xác và chỉ dẫn cách thể hiện.
Chuẩn bị ảnh đầu và cuối có bố cục tương thích. Không khớp giữa ảnh đầu vào và kích thước đầu ra có thể gây cắt ảnh hoặc thay đổi hình ảnh đột ngột; khớp kích thước và bố cục thích ứng là biện pháp được mô tả. Tập trung mô tả vào sự kiện và vai trò tham chiếu. Nhà sản xuất cảnh báo lời nhắc dài có thể làm thông tin phân tán khiến chi tiết bị bỏ qua. Xem xét chuyển động, tính liên tục tham chiếu, diễn xuất âm thanh và mối nối giữa cảnh là các phần riêng của kết quả sáng tạo.
Lên kế hoạch cú máy và chỉ dẫn văn bản
Với cảnh phức tạp, tổ chức yêu cầu thành Shot 1, Shot 2 và Shot 3, chỉ định máy quay, hành động chủ thể, vị trí và âm thanh theo thứ tự. Hướng dẫn khuyến nghị một chuyển động máy quay mỗi cú và ưu tiên hành động chậm, liên kết. Mốc thời gian chính xác theo từng cú không ổn định, vì vậy chuỗi sự kiện là cách điều khiển tốt hơn ép nhiều cửa sổ thời gian chính xác.
Mô hình còn tạo văn bản thông dụng, gồm khẩu hiệu, phụ đề và bong bóng lời thoại. Có thể chỉ đạo màu, cách thể hiện, vị trí và cách xuất hiện của chữ. Dùng ký tự thông dụng thay vì ký tự hiếm hoặc ký hiệu đặc biệt và xem xét câu chữ khi chuyển động. Với tham chiếu chủ thể, gắn rõ từng tài sản với nhân vật hoặc vật dự kiến. Các góc nhìn sản phẩm có thể cung cấp thông tin hình ảnh khác nhau; ảnh ghép xoay nhân vật có thể gây nhầm danh tính khuôn mặt. Ảnh chân dung đầu rõ và ảnh toàn thân riêng là khuyến nghị tham chiếu nhân vật được mô tả.
Hành vi cần kiểm tra trước khi biên tập
Hướng dẫn mô tả phụ đề, logo ngoài ý muốn, nhân vật trùng lặp và phong cách trôi lệch. Tư liệu nguồn sạch, nhãn nhất quán và ràng buộc tường minh giảm các rủi ro đó nhưng không bảo đảm chữ ngoài ý muốn hoặc hình người trùng biến mất. Hơn bốn người tham chiếu được báo cáo là rủi ro ổn định, khác với số tệp mô hình chấp nhận.
Kéo dài video có thể tạo bước nhảy hoặc lùi lại ở mối nối, và tiếp nối lặp lại có thể cộng dồn suy giảm chất lượng hình ảnh. Kiểm tra khung biên và hạn chế kéo dài chồng nhiều lần. Giọng tham chiếu có thể khác âm sắc nguồn; thuyết minh có thể kết thúc bằng click hoặc cắt đột ngột, với làm nhỏ dần âm thanh là biện pháp được mô tả. Chữ Hán đa âm, ít gặp hoặc có hình gần giống có thể được phát âm sai. Với hiệu ứng hoạt hình chính xác như đếm ngược, tham chiếu chuyển động cung cấp thông tin hơn yêu cầu bằng lời đơn thuần. Đây là lý do cụ thể để kiểm tra riêng danh tính, chữ, chuyển động và âm thanh khi chọn đoạn video.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Bắt đầu
ByteDance Seedance 2.0 kết hợp tạo âm thanh–video trực tiếp với tham chiếu hình ảnh, video và âm thanh. Chỉ đạo cảnh mới, chỉnh sửa cảnh quay có sẵn hoặc kéo dài một chuỗi; phiên bản tiêu chuẩn có đầu ra 1080p và 4K 10-bit được mô tả.
- Đầu vào được chấp nhận
- Văn bản · Ảnh · Âm thanh
- 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,audio- Đầu ra
video- Định dạng đầu ra
- byte MP4 gốc; không chuẩn hóa hoặc chuyển mã
| 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 bytedance/seedance-2.0 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Tối thiểu: 1 Tối đa: 600 | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 480p, 720p, 1080p, 4K | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Mặc định— |
Trườnggenerate_audio | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false, true Điều kiện: Ở 480p và 720p, bỏ generate_audio sẽ chọn giá có âm thanh, còn false chọn giá không có âm thanh. Ở 1080p và 4K, giá theo độ phân giải áp dụng cho cả hai thiết lập. Kiểm tra has_audio trong kết quả để xác định bản âm thanh được trả về. | Mặc định— |
Trườngframe_images | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 2 Nội dung đầu vào: Mảng đối tượng khung hình. Mỗi đối tượng có type=image_url, image_url chứa url và frame_type=first_frame hoặc last_frame. Mỗi vai trò xuất hiện tối đa một lần. Dùng các URL HTTPS công khai. Khóa chính xác: type, image_url, frame_type Điều kiện: Các khóa này áp dụng cho từng đối tượng khung hình. Bỏ frame_images đối với yêu cầu chỉ có văn bản. | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Nội dung đầu vào: Mảng đối tượng tham chiếu ảnh hoặc âm thanh. Đặt type thành image_url hoặc audio_url và cung cấp đối tượng URL tương ứng chứa url. Vẫn chưa thể định giá tham chiếu video. Điều kiện: Bỏ frame_images để dùng chế độ tham chiếu. Dùng các URL HTTPS công khai. | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Mẫu: ^[1-9][0-9]*x[1-9][0-9]*$ | Mặc định— |
Trườngseed | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: -9.223.372.036.854.775.808 Tối đa: 9.223.372.036.854.775.807 | Mặc định— |
Trườngcallback_url | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Mẫu: ^https:// | Mặc định— |
Trườngsession_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngtrace | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnguser | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Câu lệnh dạng văn bản. · Bắt buộc: model, prompt, duration
Cung cấp câu lệnh văn bản và thời lượng nguyên giây được hỗ trợ. Dùng kích thước chính xác được liệt kê, hoặc độ phân giải và tỷ lệ khung hình tương ứng với kích thước được liệt kê.
model: Loại: string · bytedance/seedance-2.0
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Ảnh thành video · Câu lệnh dạng văn bản và ảnh khung hình. · Bắt buộc: model, prompt, duration, frame_images
frame_images là mảng đối tượng có type=image_url, image_url chứa url và frame_type. Dùng URL ảnh HTTPS công khai; first_frame và last_frame có thể xuất hiện tối đa một lần cho mỗi vai trò. Dùng kích thước đầu ra được liệt kê hoặc kích thước tương thích. Không thêm tham chiếu video.
Khóa chính xác: type, image_url, frame_type
model: Loại: string · bytedance/seedance-2.0
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
Reference to video · Câu lệnh dạng văn bản và các tham chiếu ảnh hoặc âm thanh. · Bắt buộc: model, prompt, duration, input_references
input_references là một mảng. Mỗi đối tượng có type=image_url hoặc type=audio_url và đối tượng URL tương ứng chứa url. Dùng liên kết HTTPS công khai. Bỏ frame_images để chọn chế độ tham chiếu. Không thể định giá tham chiếu video.
model: Loại: string · bytedance/seedance-2.0
prompt: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có
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, duration |
Tham sốmaterial_types | Hợp đồngtext, image, audio |
Tham sốadditional_properties | Hợp đồngfalse |
Tham sốoptional_controls | Hợp đồngresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Vòng đời: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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í | Điều kiện 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í— | Điều kiện 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ìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíKhông có điều kiện bổ sung nào được khai báo trong khóa định giá này. | Phí Đầu ra · Giá token video · Ước tính chỉ để so sánh $0.014 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíresolution: 1080p | Phí Đầu ra · Giá token video · Ước tính chỉ để so sánh $0.0154 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíđầu vào: with_video_input; độ phân giải: 1080p | Phí reference · Giá token video · Ước tính chỉ để so sánh $0.0094 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíresolution: 4k | Phí Đầu ra · Giá token video · Ước tính chỉ để so sánh $0.008 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíđầu vào: with_video_input; độ phân giải: 4k | Phí reference · Giá token video · Ước tính chỉ để so sánh $0.0048 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíđầu vào: with_video_input | Phí reference · Giá token video · Ước tính chỉ để so sánh $0.0086 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi 1K token video | Điều kiện tính phíâm thanh: without_audio | Phí Đầu ra · Giá token video · Ước tính chỉ để so sánh $0.014 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| 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í— | Điều kiện tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.3024 ướ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 →
Chi tiết giá cước tham chiếu
Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn.
Tham chiếu giá theo cấu hình video
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 | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhGiá token video | Điều kiện tính phíKhông có điều kiện bổ sung nào được khai báo trong khóa định giá này. | Phí Đầu ra · Giá token video $0.014 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíresolution: 4k | Phí Đầu ra · Giá token video $0.008 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíresolution: 1080p | Phí Đầu ra · Giá token video $0.0154 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíâm thanh: without_audio | Phí Đầu ra · Giá token video $0.014 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíđầu vào: with_video_input | Phí reference · Giá token video $0.0086 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíđầu vào: with_video_input; độ phân giải: 4k | Phí reference · Giá token video $0.0048 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
| Cấu hìnhGiá token video | Điều kiện tính phíđầu vào: with_video_input; độ phân giải: 1080p | Phí reference · Giá token video $0.0094 mỗi 1K token video Đơn giá token video là giá tham khảo chính. Các mức giá ước tính theo giây được nêu nổi bật là giá tham khảo riêng, không phải khoản phí bổ sung. |
Ví dụ yêu cầu
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Nhận và lưu kết quả
Ailoot Ultra · Video
các URL nội dung đã ký thuộc quyền sở hữu
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kiểm tra trạng thái tác vụ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Lượt đọc nội dung khác
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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 đầu ra thực tế thuộc quyền sở hữu và siêu dữ liệu đo lường được trả về.
Nếu cần kiểm tra phản hồi gốc
503 result_pending_check + id ban đầu + X-Should-Retry:false; tuyệt đối không gửi lại yêu cầu ban đầu
Trường phản hồi
| Trường | Loại | Ý nghĩa |
|---|---|---|
Trườngindex | Loạiinteger | Ý nghĩaVị trí bắt đầu từ không của video này trong danh sách outputs. |
Trườngcontent_url | Loạistring | Ý nghĩaURL tải xuống HTTPS đã ký cho video đã hoàn tất này. |
Trườngsha256 | Loạistring | null | Ý nghĩaGiá trị băm SHA-256 của các byte video gốc; null nếu không có dữ liệu. |
Trườngsize_bytes | Loạiinteger | null | Ý nghĩaDung lượng tệp video gốc tính bằng byte; null nếu không có dữ liệu. |
Trườngduration_ms | Loạiinteger | null | Ý nghĩaThời lượng video đo được tính bằng mili giây; null nếu không có dữ liệu. |
Trườngwidth | Loạiinteger | null | Ý nghĩaChiều rộng video tính bằng pixel; null nếu không có dữ liệu. |
Trườngheight | Loạiinteger | null | Ý nghĩaChiều cao video tính bằng pixel; null nếu không có dữ liệu. |
Trườngvideo_codec | Loạistring | null | Ý nghĩaMã định danh codec video; null nếu chưa được ghi nhận. |
Trườnghas_audio | Loạiboolean | null | Ý nghĩaVideo có chứa bản âm thanh hay không; null nếu chưa được đo. |
Trườngaudio_codec | Loạistring | null | Ý nghĩaMã định danh codec âm thanh; null khi chưa ghi nhận mã định danh. |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi404 · not_found_error | Điều kiệnKhông thể truy cập video hoặc không tìm thấy ID video này. | Bước tiếp theoKiểm tra quyền truy cập video. Với video hiện có, dùng ID công khai ban đầu và cùng khóa API. |
Phản hồi401 · authentication_error | Điều kiệnKhóa API không khớp với tài khoản đã xác thực. | Bước tiếp theoKiểm tra khóa API và quyền truy cập tài khoản trước khi gửi. |
Phản hồi400 · invalid_request_error | Điều kiệnKhông thể đọc yêu cầu hoặc chỉ số tải xuống không hợp lệ. | Bước tiếp theoSửa nội dung yêu cầu. Để tải xuống, chọn một chỉ số đầu ra được tác vụ ban đầu trả về. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể định giá cấu hình video đã chọn. | Bước tiếp theoChọn cấu hình video được hỗ trợ và điền đầy đủ các tùy chọn bắt buộc trước khi gửi yêu cầu đã sửa. |
Phản hồi422 · invalid_request_error | Điều kiệnĐầu vào video hoặc tác vụ tiếp nối ban đầu không hợp lệ. | Bước tiếp theoDùng đầu vào HTTPS hợp lệ. Để tiếp nối, dùng ID video công khai ban đầu đã hoàn tất của bạn với cùng khóa API. |
Phản hồi402 · billing_error | Điều kiệnSố dư khả dụng hoặc các giới hạn không cho phép giữ trước số tiền. | Bước tiếp theoKiểm tra số dư khả dụng và các giới hạn trước khi gửi yêu cầu mới. |
Phản hồi503 · server_error | Điều kiệnTạm thời không thể xác minh video, lưu trữ hoặc truy cập dịch vụ. | Bước tiếp theoĐợi dịch vụ khả dụng. Nếu đã có ID video, kiểm tra tác vụ ban đầu đó thay vì tạo thêm video. |
Phản hồi503 · result_pending_check | Điều kiệnKết quả video và khoản phí ban đầu cần được kiểm tra. | Bước tiếp theoGiữ lại ID video được trả về và kiểm tra tác vụ đó. Không gửi yêu cầu tạo thay thế trong khi tác vụ đang được kiểm tra. |
Phản hồi503 · owned_result_unavailable | Điều kiệnTạm thời không thể tải xuống video hiện có. | Bước tiếp theoKiểm tra lại cùng tác vụ video sau và tải xuống đầu ra hiện có. Một lần tạo mới sẽ tạo thao tác riêng. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung video chưa được công bố. | Bước tiếp theoKiểm tra trạng thái tác vụ ban đầu. Tải xuống sau khi trạng thái là completed; nếu là failed, làm theo thông báo kiểm tra khoản phí. |
Bí danh
Bí danh mô hình
Ailoot Ultra bytedance/seedance-2.0
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · ByteDance: Seedance 2.0
- Có những đầu vào và kết quả nào?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Áp dụng những giới hạn nào?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807