Hướng dẫn media
Các mô hình video Seedance 2.0
Chọn một mô hình Seedance 2.0 và bắt đầu tạo video
Trang này giúp bạn chọn mô hình và API Seedance 2.0. Các hướng dẫn riêng biệt bao gồm việc di chuyển từ Volcengine, các tài nguyên có thể tái sử dụng và xác thực người thật.
Chọn API
| Bạn đang xây dựng gì | Sử dụng | Hướng dẫn |
|---|---|---|
| Xây dựng tích hợp video TokenLab mới | API POST /v1/videos/generations hợp nhất | Tạo video |
| Di chuyển client Seedance Volcengine hiện có | Các endpoint REST hoặc Action tương thích với Volc | Di chuyển Seedance từ Volcengine |
| Tái sử dụng các tham chiếu avatar ảo, sản phẩm, phong cách hoặc người thật | Thư viện tài nguyên TokenLab | Tài nguyên Seedance và xác thực người thật |
Mọi tùy chọn đều sử dụng Authorization: Bearer <TOKENLAB_API_KEY>. Các yêu cầu tương thích với Volc giữ nguyên các trường của Volcengine nhưng sử dụng khóa TokenLab thay vì ký AK/SK.
Lựa chọn mô hình
| Mô hình | Độ phân giải được hỗ trợ |
|---|---|
seedance-2.0 | 480p, 720p, 1080p, 4k |
seedance-2.0-fast | 480p, 720p |
seedance-2.0-mini | 480p, 720p |
seedance-2.0-fast và seedance-2.0-mini sẽ từ chối các yêu cầu 1080p và 4k. Các mô hình Seedance mới hơn như seedance-2.5 sử dụng các thao tác tương tự; hãy đọc GET /v1/models/seedance-2.5 để biết độ phân giải và thời lượng của chúng. Hãy truy vấn Models API khi cần quyết định tính khả dụng của mô hình tại thời điểm chạy (runtime).
Các thao tác được hỗ trợ
| Thao tác | Đầu vào điển hình |
|---|---|
text-to-video | prompt |
image-to-video | prompt, image_url hoặc đầu vào hình ảnh tương thích |
start-end-to-video | prompt, start_image, end_image |
reference-to-video | prompt, reference_images, tùy chọn video_urls, tùy chọn audio_urls |
video-to-video | prompt, video_url hoặc đầu vào video tương thích |
video-extension | task_id hoặc đầu vào tiếp nối dành riêng cho mô hình |
Hãy đặt operation một cách rõ ràng để API có thể xác thực các trường cho loại tạo video đó.
Định dạng tác vụ tương thích với Volcengine chấp nhận tối đa 9 hình ảnh, 3 video và 3 tệp âm thanh cho mỗi tác vụ seedance-2.0. POST /v1/videos/generations không chỉ định giới hạn số lượng cho các đầu vào tham chiếu, vì vậy đừng tự suy diễn giới hạn từ ví dụ.
Kết quả và Định giá
Việc tạo video là không đồng bộ (asynchronous). Hãy lưu trữ ID tác vụ được trả về. Đối với API hợp nhất, hãy thực hiện polling GET /v1/tasks/{id} cho đến khi tác vụ đạt trạng thái cuối cùng. Các tác vụ tương thích với Volc giữ nguyên đường dẫn tác vụ của Volcengine, GET /api/v3/contents/generations/tasks/{id}. Xem Các tác vụ không đồng bộ và Polling để biết hướng dẫn về thử lại và timeout.
Định giá phụ thuộc vào mô hình, độ phân giải đầu ra và loại đầu vào. Hãy đọc thông tin này từ Pricing API thay vì mã hóa cứng (hard-coding) vào sản phẩm của bạn.
Tham chiếu API
| Chủ đề | Tham chiếu |
|---|---|
| Tạo tác vụ video hợp nhất | Tạo video |
| Poll một tác vụ hợp nhất | Lấy trạng thái tác vụ |
| Các thao tác tác vụ tương thích với Volc | Tạo tác vụ (Tương thích với Volc) |
| Các thao tác tài nguyên tương thích với Volc | Thao tác tài nguyên (Tương thích với Volc) |