# Seedance 2.5 Flash API Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Seedance 2.5 Flash của ByteDance. ## Các biến thể mô hình API này hỗ trợ ba biến thể mô hình sau. | Mô hình | ID | Mô tả | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | Tạo video chất lượng cao từ văn bản | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | Tạo video từ khung hình đầu hoặc từ cả khung hình đầu và cuối | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | Tạo video dựa trên hình ảnh, video và âm thanh tham chiếu | ## So sánh nhanh | Tính năng | Tạo video từ văn bản | Tạo video từ hình ảnh | Tạo video từ tư liệu tham chiếu | |---------|---------------|----------------|--------------------| | Khoảng thời lượng | 4–30 giây | 4–30 giây | 4–30 giây | | Tùy chọn độ phân giải | 480p, 720p | 480p, 720p | 480p, 720p | | Tỷ lệ khung hình | Không bắt buộc (mặc định 16:9) | Không hỗ trợ | Không bắt buộc (mặc định 16:9) | | Tư liệu bắt buộc | Không có | Ảnh khung hình đầu | Không có | | Tư liệu không bắt buộc | Không có | Ảnh khung hình cuối | Hình ảnh, video và âm thanh | ### Tỷ lệ khung hình được hỗ trợ Tạo video từ văn bản và từ tư liệu tham chiếu hỗ trợ các tỷ lệ sau. `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` Mô hình tạo video từ hình ảnh không hỗ trợ tham số `aspect_ratio`. ### Tùy chọn độ phân giải | Độ phân giải | Mô tả | |------------|-------------| | `480p` | Độ nét tiêu chuẩn | | `720p` | Độ nét cao | ## Seedance 2.5 Flash Text to Video ### Điểm cuối ``` POST /api/v1/video/task ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | Câu lệnh tạo video, tối đa 5000 ký tự | | `resolution` | string | Độ phân giải đầu ra là `"480p"` hoặc `"720p"`. Không có giá trị mặc định | | `duration` | integer | Thời lượng video là số nguyên từ 4 đến 30 giây, mỗi bước 1 giây. Không có giá trị mặc định | #### Không bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `aspect_ratio` | string | Tỷ lệ khung hình video là `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` hoặc `"3:4"`. Mặc định là `"16:9"` | | `sound` | boolean | Cho biết có tạo âm thanh hay không. Mặc định là `true`. Đặt thành `false` để tạo video không có tiếng | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'seedance-v2.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | Câu lệnh tạo video, tối đa 5000 ký tự | | `resolution` | string | Độ phân giải đầu ra là `"480p"` hoặc `"720p"`. Không có giá trị mặc định | | `duration` | integer | Thời lượng video là số nguyên từ 4 đến 30 giây, mỗi bước 1 giây. Không có giá trị mặc định | | `image_url` | string | URL của ảnh khung hình đầu. Xem mục Giới hạn tư liệu bên dưới. Video đầu ra có cùng tỷ lệ khung hình với ảnh này | #### Không bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `image_end_url` | string | URL của ảnh khung hình cuối (không bắt buộc). Xem mục Giới hạn tư liệu bên dưới. Nên dùng cùng tỷ lệ khung hình với khung hình đầu | | `sound` | boolean | Cho biết có tạo âm thanh hay không. Mặc định là `true`. Đặt thành `false` để tạo video không có tiếng | > Khi yêu cầu tạo video từ hình ảnh, hãy bỏ qua `aspect_ratio` vì mô hình này không hỗ trợ tham số đó. ### Ví dụ yêu cầu ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | Câu lệnh tạo video, tối đa 5000 ký tự. Có thể viết câu lệnh thông thường không dùng ký hiệu giữ chỗ hoặc dùng tính năng tham chiếu @ (AT) với `<<>>`, `<<>>` và `<<>>` để chỉ rõ các phần tử trong mảng tư liệu tương ứng | | `resolution` | string | Độ phân giải đầu ra là `"480p"` hoặc `"720p"`. Không có giá trị mặc định | | `duration` | integer | Thời lượng video là số nguyên từ 4 đến 30 giây, mỗi bước 1 giây. Không có giá trị mặc định | #### Tư liệu tham chiếu Mọi tư liệu tham chiếu đều không bắt buộc. Yêu cầu có thể chỉ dùng ảnh, chỉ dùng video, chỉ dùng âm thanh hoặc không dùng tư liệu tham chiếu. Khi không dùng tư liệu tham chiếu, nên chọn mô hình tạo video từ văn bản. | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `images` | string[] | Từ 0 đến 10 URL ảnh tham chiếu, được tham chiếu theo thứ tự trong mảng. Xem mục Giới hạn tư liệu bên dưới | | `videos` | string[] | Từ 0 đến 5 URL video tham chiếu định dạng MP4 hoặc MOV. Mỗi video dài 2–30 giây, tổng thời lượng tối đa 30 giây. Xem mục Giới hạn tư liệu bên dưới. Khi tính phí, tổng thời lượng video tham chiếu được làm tròn đến giây gần nhất (nửa giây làm tròn lên) rồi cộng với thời lượng video đầu ra | | `audios` | string[] | Từ 0 đến 5 URL âm thanh tham chiếu định dạng WAV hoặc MP3. Mỗi đoạn dài 2–30 giây và không quá 15 MB, tổng thời lượng tối đa 30 giây | #### Ký hiệu giữ chỗ cho tham chiếu @ (AT) Tính năng tham chiếu @ (AT) liên kết tư liệu với câu lệnh bằng các ký hiệu giữ chỗ `<<<...>>>` có đánh số. Mỗi loại tư liệu được đánh số riêng từ `1` theo thứ tự trong mảng tương ứng. | Ký hiệu giữ chỗ | Giá trị được tham chiếu | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | Ví dụ, nếu ảnh đầu dùng để tham chiếu nhân vật và ảnh thứ hai dùng để tham chiếu bối cảnh, hãy dùng `<<>>` cho nhân vật và `<<>>` cho bối cảnh trong `prompt`. Mỗi ký hiệu giữ chỗ phải trỏ đến một phần tử có trong mảng tương ứng. #### Không bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `aspect_ratio` | string | Tỷ lệ khung hình video là `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` hoặc `"3:4"`. Mặc định là `"16:9"` | | `sound` | boolean | Cho biết có tạo âm thanh hay không. Mặc định là `true`. Đặt thành `false` để tạo video không có tiếng | ### Ví dụ yêu cầu ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### Ví dụ yêu cầu tạo video từ tư liệu tham chiếu bằng @ (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## Giới hạn tư liệu Các giới hạn sau áp dụng cho ảnh khung hình đầu, ảnh khung hình cuối và tư liệu tham chiếu của các mô hình trên trang này. | Tư liệu | Định dạng | Giới hạn | |-------|---------|--------| | Hình ảnh | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Mỗi ảnh dưới 30 MB. Chiều rộng và chiều cao đều từ 300 đến 6000 px, tỷ lệ chiều rộng trên chiều cao từ 0,4 đến 2,5 | | Video | MP4, MOV | Mỗi video tối đa 200 MB. Chiều rộng và chiều cao đều từ 300 đến 6000 px, tỷ lệ chiều rộng trên chiều cao từ 0,4 đến 2,5, tốc độ khung hình từ 24 đến 60 FPS và tổng số điểm ảnh từ 407696 đến 8295044 | | Âm thanh | WAV, MP3 | Tối đa 15 MB mỗi tệp | Âm thanh tham chiếu và video tham chiếu có giới hạn tổng thời lượng riêng là 30 giây cho mỗi loại. Số lượng cũng được tính riêng, tối đa 10 ảnh, 5 video và 5 đoạn âm thanh. Mọi mô hình đều yêu cầu `resolution` và `duration` và không có giá trị mặc định cho hai tham số này. Khi bỏ qua `aspect_ratio`, mô hình tạo video từ văn bản và từ tư liệu tham chiếu dùng tỷ lệ mặc định `16:9`. Tùy chọn âm thanh mặc định là `true`. Đặt thành `false` để tạo video không có tiếng. ## Định dạng phản hồi ### Phản hồi ban đầu Mọi mô hình đều trả về `task_id` để truy vấn trạng thái định kỳ. ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Phản hồi khi truy vấn trạng thái Gọi `GET /api/v1/video/{taskId}` định kỳ để kiểm tra trạng thái. ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Giá trị trạng thái - `submitted`: Đã tiếp nhận tác vụ và đang chờ xử lý - `processing`: Đang tạo video - `succeed`: Đã tạo video xong - `failed`: Tạo video thất bại ## Thời gian xử lý Thời gian xử lý phụ thuộc vào thời lượng, độ phân giải và tình trạng hàng đợi hiện tại. Truy vấn lại sau mỗi 5–10 giây để kiểm tra trạng thái. ## Khuyến nghị sử dụng 1. **Tham số bắt buộc**: Luôn cung cấp `prompt`, `resolution` và `duration`. Khi tạo video từ văn bản hoặc từ tư liệu tham chiếu, `aspect_ratio` là tùy chọn và mặc định là `16:9` 2. **Tỷ lệ khi tạo video từ ảnh**: Không gửi `aspect_ratio` trong yêu cầu tạo video từ hình ảnh 3. **Video tham chiếu**: Video không bắt buộc. Thời lượng của từng video và tổng thời lượng phải nằm trong giới hạn đã nêu 4. **Ảnh tham chiếu**: Ảnh không bắt buộc, bất kể có video hay âm thanh hay không. Có thể gửi tối đa 10 URL ảnh thuộc định dạng hỗ trợ 5. **Âm thanh tham chiếu**: Mỗi đoạn phải dài 2–30 giây và không quá 15 MB, với tổng thời lượng không quá 30 giây 6. **Thứ tự tham chiếu**: Sắp xếp các phần tử trong `images`, `videos` và `audios` theo thứ tự mong muốn rồi tham chiếu nhất quán trong câu lệnh 7. **Âm thanh**: Bỏ qua `sound` để dùng giá trị mặc định `true`, hoặc đặt thành `false` để tắt tính năng tạo âm thanh