ByteDance: Seedance 2.0 Mini
Seedance 2.0 Mini tạo video ngắn với âm thanh được tạo tùy chọn từ văn bản, hình ảnh, video và tham chiếu âm thanh. Mô hình hỗ trợ tạo cảnh, chỉnh sửa video có mục tiêu và tiếp nối, với cấu hình đầu ra 480p hoặc 720p đượ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 Mini là một mô hình có tên riêng trong họ âm thanh–video Seedance 2.0 của ByteDance. Nhà sản xuất mô tả chuyển văn bản thành video, chuyển ảnh thành video với khung đầu hoặc khung đầu và cuối, tạo theo tham chiếu đa phương thức, chỉnh sửa và kéo dài video. Âm thanh có thể được tạo cùng hình ảnh. Chọn chế độ theo tư liệu đã có: bản mô tả viết, hình mở đầu cố định, hai khung biên hoặc đoạn video cần chỉnh sửa hay tiếp nối.
Mini có cấu hình đầu ra riêng. Nhà sản xuất liệt kê video 480p và 720p với màu 8-bit, 24 khung hình mỗi giây và đầu ra MP4. Các tỷ lệ khung hình được hỗ trợ là 21:9, 16:9, 4:3, 1:1, 3:4 và 9:16; thời lượng tạo được mô tả là 4–15 giây. Điều khiển thời lượng của nhà sản xuất còn cho phép tự động chọn trong phạm vi đó. Các lựa chọn 1080p và 4K của mô hình Seedance 2.0 đầy đủ là riêng biệt; chúng không phải thiết lập Mini. Bảng năng lực của họ mô hình liệt kê việc trả lại khung hình cuối được tạo, còn chế độ Draft không được hỗ trợ.
Tham chiếu omni tạo cảnh mới bằng thông tin đã chọn từ tư liệu cung cấp. Hình ảnh có thể xác định diện mạo chủ thể, bố cục hoặc cách thể hiện hình ảnh. Video có thể xác lập hành động, chuyển động máy quay hoặc hiệu ứng; tham chiếu âm thanh có thể xác lập âm sắc giọng, giai điệu hoặc lời nói. Nói rõ cần lấy gì từ mỗi tham chiếu thay vì yêu cầu sao chép mọi thuộc tính. Ví dụ, dùng ảnh sản phẩm cho hình dạng và màu sắc, đoạn chuyển động máy quay ngắn cho cách tiếp cận và tham chiếu âm thanh cho không khí.
Quy trình của họ mô hình cho phép đến chín ảnh tham chiếu, ba đoạn video và ba đoạn âm thanh. Mỗi video tham chiếu dài 2–15 giây, tổng không quá 15 giây; tham chiếu âm thanh dùng cùng giới hạn cho từng đoạn và tổng thời lượng. Chỉ âm thanh và văn bản cộng âm thanh không có tham chiếu hình ảnh không phải các tổ hợp được hỗ trợ. Tạo chỉ từ văn bản là chế độ được hỗ trợ riêng. Với một chuỗi, cung cấp tài sản theo thứ tự dự kiến và tham chiếu nhất quán bằng Image 1, Video 1 hoặc Audio 1, theo thứ tự trong từng loại phương tiện. Không thay tham chiếu có số trong lời nhắc viết bằng mã định danh tài sản.
Ảnh khung đầu xác định phần mở đầu của cú máy dựa trên ảnh. Chế độ khung đầu và cuối xác định cả hai biên. Nếu những ảnh biên chính xác đó quan trọng, chọn chế độ chuyên biệt thay vì mô tả tham chiếu là mở đầu và kết thúc trong lời nhắc omni. Cách sau là hiệu ứng được chỉ dẫn bằng lời nhắc, không tương đương lựa chọn khung biên nghiêm ngặt. Chuẩn bị ảnh cho bố cục đầu ra và nêu hành động nối tình huống bắt đầu với kết thúc.
Chỉnh sửa video thay đổi đoạn có sẵn thay vì chỉ dùng nó làm cảm hứng. Xác định video cần sửa, vật hoặc vùng cần đổi, thời điểm xuất hiện và vị trí, cùng chi tiết cần giữ. Một bản yêu cầu hữu ích là “Trong Video 1, thay chiếc cốc bằng vật đựng trong Image 1; giữ chuyển động tay, bố cục khung hình, ánh sáng và cách sắp xếp trên bàn.” Với việc xóa, nêu vật không mong muốn và các yếu tố xung quanh phải giữ lại. Nhà sản xuất khuyên tham chiếu trực tiếp video đích khi chỉnh sửa hoặc kéo dài; gọi nó là tham chiếu có thể lại truyền đạt yêu cầu tạo cảnh mới.
Kéo dài video bổ sung sự kiện trước hoặc sau đoạn có sẵn. Mô tả chiều tiếp nối và điều xảy ra tiếp theo hoặc trước đó. Quy trình được mô tả còn có thể nối hai hoặc ba đoạn bằng chuyển cảnh được tạo; cả ba video đầu vào vẫn phải nằm trong tổng tham chiếu 15 giây. Hướng dẫn phân biệt tiếp nối chủ yếu gồm phần cảnh ở biên của đoạn gốc với yêu cầu giữ rõ ràng nội dung gốc. Nêu thành phần kết quả mong muốn: chỉ phần tiếp nối, hoặc cảnh chứa đoạn được cung cấp cùng hành động mới.
Để chỉ đạo rõ ràng, tách mô tả cảnh ổn định khỏi chuỗi sự kiện. Xác định mỗi chủ thể bằng hai hoặc ba đặc điểm hình ảnh phân biệt và nhãn nhất quán. Sau đó mô tả hành động, bối cảnh, ánh sáng, chuyển động máy quay, phong cách hình ảnh và ràng buộc. Trong hội thoại, gắn từng câu với người nói và hành động liên quan. Dùng nhãn cú máy có thứ tự thay vì coi mốc thời gian chính xác là điều khiển đáng tin: nhà sản xuất lưu ý thời điểm chính xác có thể không ổn định. Bản mô tả sản phẩm được dàn dựng có thể là: “Image 1 xác định Product A. Shot 1: từ từ tiến tới Product A trên quầy. Shot 2: một bàn tay xoay sản phẩm về phía ánh sáng. Shot 3: dừng ở nhãn phía trước. Âm nền căn phòng nhẹ; giữ chữ in.”
Chuẩn bị tham chiếu theo quy tắc đầu vào của họ mô hình được mô tả. Các định dạng ảnh được hỗ trợ gồm JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC và HEIF; mỗi ảnh nhỏ hơn 30 MB. Hướng dẫn quy định chiều rộng và cao của ảnh đều lớn hơn 300 và nhỏ hơn 6,000 pixel, tỷ lệ khung hình lớn hơn 0.4 và nhỏ hơn 2.5. Video tham chiếu dùng MP4 hoặc MOV với video H.264 hoặc H.265 và âm thanh AAC hoặc MP3, mỗi tệp tối đa 200 MB và có 24–60 khung hình mỗi giây. Chiều rộng và cao là 300–6,000 pixel, tỷ lệ 0.4–2.5 và tổng số pixel 407,696–8,295,044. Âm thanh tham chiếu dùng WAV hoặc MP3, tối đa 15 MB mỗi tệp. Đây là đặc tả chuẩn bị đầu vào của nhà sản xuất, tách biệt với điều khiển tải lên của ứng dụng cụ thể.
Quy trình chân dung của nhà sản xuất đòi hỏi chuẩn bị riêng cho ảnh hoặc video chứa khuôn mặt người thật: tải tham chiếu trực tiếp không phải quy trình tiêu chuẩn được hỗ trợ. Tài liệu mô tả đầu ra mô hình đáng tin, nhân vật số cài sẵn và quy trình tài sản người thật được cho phép là các giải pháp riêng. Khớp giọng, phát âm và âm thanh tại biên đoạn video cũng cần kiểm tra. Hướng dẫn lời nhắc khuyên mô tả đặc tính giọng mong muốn và giữ phong cách hội thoại gần tham chiếu âm thanh. Xem xét sản phẩm cuối về tính nhất quán chủ thể, lời nói chính xác, thời điểm hành động, chuyển khung và âm thanh kết thúc; tinh chỉnh yếu tố cụ thể khác với bản mô tả.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0-mini
bytedance/seedance-2.0-miniBắt đầu
Seedance 2.0 Mini tạo video ngắn với âm thanh được tạo tùy chọn từ văn bản, hình ảnh, video và tham chiếu âm thanh. Mô hình hỗ trợ tạo cảnh, chỉnh sửa video có mục tiêu và tiếp nối, với cấu hình đầu ra 480p hoặc 720p đượ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-mini | 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 | 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: Bỏ generate_audio sẽ chọn giá có âm thanh; false chọn giá không có âm thanh. Kiểm tra has_audio trong kết quả để biết có bản âm thanh được trả về hay không. | 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 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-mini
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-mini
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-mini
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.007 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.0042 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.007 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.1512 ướ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.007 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.007 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.0042 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-mini","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-mini
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 Mini
- Có những đầu vào và kết quả nào?
POST /v1/videos·bytedance/seedance-2.0-mini:text,image,audio→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·bytedance/seedance-2.0-mini: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-mini:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807