Source: https://ailoot.ai/models/vi/bytedance-seedance-2-5/
Canonical: https://ailoot.ai/models/vi/bytedance-seedance-2-5/
Language: vi

# ByteDance: Seedance 2.5

[Markdown](https://ailoot.ai/models/vi/bytedance-seedance-2-5/index.md) · [JSON](https://ailoot.ai/models/vi/bytedance-seedance-2-5/facts.json)

## [ByteDance: Seedance 2.5](https://ailoot.ai/models/vi/bytedance-seedance-2-5/)

Seedance 2.5 tạo đồng thời âm thanh và video cho các cảnh dài hơn, tham chiếu hình ảnh/video/âm thanh phong phú và chỉnh sửa có mục tiêu. ByteDance Seed mô tả khả năng tạo đến 30 giây, hướng dẫn bằng bản dựng clay, điều khiển máy quay và tiếp nối cảnh quay có sẵn.

- [**Ailoot Ultra · Video** `POST /v1/videos` `bytedance/seedance-2.5`](https://ailoot.ai/models/vi/bytedance-seedance-2-5/#method-0)

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.5 là mô hình tạo kết hợp âm thanh và video của ByteDance Seed. Mô hình phát triển từ Seedance 2.0 với khả năng kể chuyện dài hơn, tham chiếu đa phương thức phong phú hơn và chỉnh sửa chính xác hơn. Một bản mô tả bằng văn bản có thể xác định cảnh, trong khi hình ảnh, video và âm thanh truyền đạt diện mạo, chuyển động, ngôn ngữ máy quay và âm thanh. Kết quả là cảnh quay có hình và tiếng cho ý tưởng phim, câu chuyện sản phẩm, video âm nhạc, tiền kỳ trực quan hoặc truyện ngắn.

Một cảnh hoàn chỉnh trong một lần tạo Nhà sản xuất nâng trần tạo trong một lần từ 15 giây trước đây lên đến 30 giây. Nhờ đó, bản mô tả có đủ chỗ cho mở đầu, phát triển và kết thúc, với nhiều cú máy liên kết hoặc một chuyển động máy quay liên tục. Ví dụ biểu diễn sân khấu của nhà sản xuất theo chân ca sĩ từ phòng thay đồ qua hành lang lên sân khấu, thay vì chỉ thể hiện lúc xuất hiện. Mô tả chuỗi hành động và đường đi của máy quay theo đúng thứ tự dự kiến. Với câu chuyện sản phẩm, lên kế hoạch hé lộ, trình diễn và bố cục kết thúc để mỗi nhịp đều bổ sung điều nhìn thấy được.

Tiếp nối cảnh quay có sẵn Seedance 2.5 có thể kéo dài đoạn video về phía sau hoặc phía trước theo thời gian, dùng nhân vật, môi trường, chuyển động và hướng máy quay đã xác lập làm dấu hiệu duy trì tính liên tục. Tiếp nối về sau mô tả điều xảy ra sau khoảnh khắc cuối; tiếp nối về trước mô tả phần dẫn vào đoạn mở đầu. Cung cấp cảnh quay có sẵn và giải thích hành động mới, thay đổi bối cảnh hoặc chuyển động máy quay. Xem xét cả mối nối và đoạn mới, gồm diện mạo chủ thể, âm thanh và hướng chuyển động. Bài ra mắt của nhà sản xuất đề cập kéo dài nhiều lần, trong khi trang mô hình mô tả hai bước kéo dài; số lần kéo dài dùng được thuộc quy trình cụ thể thay vì lời hứa phổ quát về video không giới hạn.

Tham chiếu hình ảnh, video và âm thanh Số lượng tham chiếu được công bố là đến 50 tài sản trong một lần tạo: 30 hình ảnh, 10 đoạn video và 10 đoạn âm thanh. Hình ảnh có thể xác lập nhân vật, sản phẩm, địa điểm, đạo cụ hoặc phong cách. Video có thể truyền đạt diễn xuất, nhịp và chuyển động máy quay. Âm thanh có thể cung cấp hội thoại, nhạc, không khí hoặc tiết tấu. Gán cho mỗi tài sản một vai trò rõ ràng: một tham chiếu cho chủ thể, một tham chiếu khác cho môi trường, video cho chuyển động máy quay và đoạn âm thanh cho thời điểm. Các tư liệu này hướng dẫn cách diễn giải; chúng không bảo đảm mọi chi tiết được tái hiện chính xác.

Hướng dẫn bằng bản dựng clay và dàn dựng diễn xuất Một cảnh 3D không có chất liệu có thể xác định bố cục không gian, tư thế, đường chuyển động và góc máy trước khi dựng diện mạo cuối cùng. Nhà sản xuất minh họa việc dùng cấu trúc bản dựng clay này cùng một hình ảnh riêng cho thiết kế nhân vật, chất liệu, màu sắc và không khí. Cách này hữu ích cho hoạt hình hoặc hình ảnh lắp ráp mà việc dàn cảnh quan trọng hơn tham chiếu phong cách chung chung. Nêu rõ nguồn nào điều khiển dàn dựng và nguồn nào điều khiển diện mạo. Mô hình còn dùng dấu hiệu không gian để hướng dẫn chiều ánh sáng, nhiệt độ màu, cường độ và vị trí bóng đổ.

Chỉnh sửa theo mốc thời gian và điều khiển máy quay Seedance 2.5 hỗ trợ nhắm một khoảng thời gian trong lúc tạo và sửa nhân vật, hành động hoặc yếu tố câu chuyện trong đoạn video có sẵn. Chỉnh sửa theo mốc thời gian có thể tác động cả âm thanh và hình ảnh; xác định khoảng thời gian và yếu tố cần sửa. Nhà sản xuất minh họa thay phông xanh, chỉnh sửa theo tham chiếu và đổi chuyển động máy quay trong khi giữ hành động và phong cách của cảnh. Bản yêu cầu chỉnh sửa nên xác định đoạn nguồn, khoảng thời gian, yếu tố cần thay đổi và tính liên tục cần giữ. Ví dụ, mô tả thay đổi ánh sáng hoặc hậu cảnh trong một đoạn thay vì yêu cầu thiết kế lại cả bộ phim. Sau chỉnh sửa, kiểm tra các khoảnh khắc trước và sau khoảng đó cùng nội dung đã sửa.

Đầu ra có hình và tiếng, sáng tạo đa ngôn ngữ Đặc tả sản phẩm của nhà sản xuất mô tả việc tạo 4–30 giây ở 480p, 720p hoặc 1080p, 24 FPS, với đầu ra MP4 hoặc MOV. Phần giới thiệu chính thức mô tả hỗ trợ trực tiếp hơn 10 ngôn ngữ và sáng tạo lấy hội thoại làm trung tâm. Đây là năng lực và lựa chọn định dạng của nhà sản xuất; chúng không xác định hợp đồng về tệp đầu vào, thời lượng hoặc định dạng đầu ra của Ailoot. Với nội dung dựa trên hội thoại, chỉ định lời nói dự kiến và quan hệ với hành động, rồi nhờ người thông thạo ngôn ngữ xem xét câu chữ và phát âm trước khi dùng phiên bản bản địa hóa.

Ứng dụng và giới hạn thực chất Mô hình hữu ích cho ý tưởng chiến dịch, trình diễn sản phẩm, truyện có nhân vật làm trung tâm và xem trước chân thực từ cảnh quay tham chiếu hoặc dàn dựng 3D đơn giản. Nhà sản xuất còn minh họa giải thích giáo dục và hình ảnh sản xuất hoặc lắp ráp. Cảnh hướng dẫn hoặc mô phỏng được tạo vẫn cần được đối chiếu với quy trình thực tế đang minh họa. Bản phát hành nêu rõ vật lý của chuyển động phức tạp và tương tác ổn định giữa nhiều chủ thể là những mặt cần cải thiện thêm. Kiểm tra tiếp xúc giữa tay và vật, tương tác nhóm, đường chuyển động, tính nhất quán nhân vật và thời điểm khớp âm thanh với hình ảnh trên toàn bộ đoạn video. Khung hình mở đầu tốt không xác lập rằng toàn bộ chuỗi tuân theo bản mô tả.

**Ailoot Ultra · Video** `POST /v1/videos` `bytedance/seedance-2.5`

[`bytedance/seedance-2.5`](https://ailoot.ai/models/vi/#m=bytedance%2Fseedance-2.5&route=Ultra&caller=bytedance%2Fseedance-2.5&fmt=videos)

ByteDance /`bytedance/seedance-2.5`

### Bắt đầu

Seedance 2.5 tạo đồng thời âm thanh và video cho các cảnh dài hơn, tham chiếu hình ảnh/video/âm thanh phong phú và chỉnh sửa có mục tiêu. ByteDance Seed mô tả khả năng tạo đến 30 giây, hướng dẫn bằng bản dựng clay, điều khiển máy quay và tiếp nối cảnh quay có sẵn.

Đầ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ường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn bytedance/seedance-2.5 | Mặc định— |
| Trường`prompt` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`duration` | Loại`integer` | 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, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Tối thiểu: 1 Tối đa: 600 | Mặc định— |
| Trường`resolution` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 480p, 720p | Mặc định— |
| Trường`aspect_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 | Mặc định— |
| Trường`generate_audio` | Loại`boolean` | 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ường`frame_images` | Loại`array` | 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ường`input_references` | Loại`array` | 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ường`size` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 854x480, 752x560, 640x640, 560x752, 480x854, 992x432, 1280x720, 1112x834, 960x960, 834x1112, 720x1280, 1470x630 Mẫu: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ Điều kiện: Với các kích thước được liệt kê khác 1280x720, bỏ aspect\_ratio. Có thể kết hợp 1280x720 với 16:9. Nếu cung cấp resolution, giá trị phải khớp với bậc 480p hoặc 720p của kích thước đã chọn. | Mặc định— |
| Trường`seed` | Loại`integer` | 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ường`callback_url` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Mẫu: ^https:// | Mặc định— |
| Trường`session_id` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`trace` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`user` | Loại`string` | 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.5

`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.5

`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.5

`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.0214** 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.0128** 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.0214** 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.822402** ướ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 →](https://ailoot.ai/docs/vi/billing/reserve/)

#### 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.0214** 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.0214** 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.0128** 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

curl · tạo video

```bash
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.5","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"854x480","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ụ

GET trạng thái thao tác gốc

```bash
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

Lưu mọi đầu ra đã hoàn tất thuộc về bạn

```bash
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ường`index` | Loạiinteger | Ý nghĩaVị trí bắt đầu từ không của video này trong danh sách outputs. |
| Trường`content_url` | Loạistring | Ý nghĩaURL tải xuống HTTPS đã ký cho video đã hoàn tất này. |
| Trường`sha256` | 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ường`size_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ường`duration_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ường`width` | Loạiinteger \| null | Ý nghĩaChiều rộng video tính bằng pixel; null nếu không có dữ liệu. |
| Trường`height` | Loạiinteger \| null | Ý nghĩaChiều cao video tính bằng pixel; null nếu không có dữ liệu. |
| Trường`video_codec` | Loạistring \| null | Ý nghĩaMã định danh codec video; null nếu chưa được ghi nhận. |
| Trường`has_audio` | Loạiboolean \| null | Ý nghĩaVideo có chứa bản âm thanh hay không; null nếu chưa được đo. |
| Trường`audio_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.5`](https://ailoot.ai/models/vi/#m=bytedance%2Fseedance-2.5&route=Ultra&caller=bytedance%2Fseedance-2.5&fmt=videos)

#### 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

[`bytedance/seedance-2.5`](https://ailoot.ai/models/vi/#m=bytedance%2Fseedance-2.5&route=Ultra&caller=bytedance%2Fseedance-2.5&fmt=videos)

FAQ · ByteDance: Seedance 2.5

Có những đầu vào và kết quả nào?

`POST /v1/videos` · `bytedance/seedance-2.5`: `text`, `image`, `audio` → `video`

Yêu cầu sử dụng những trường nào?

`POST /v1/videos` · `bytedance/seedance-2.5`: `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.5`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

## Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

## Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao

Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.

Mã giảm đến 50%

Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.

Chi phí trong lịch sử

Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

[Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/)

## Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại

Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.

Giấy phép bán lại

Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.

Tài liệu trên website

Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

[Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.