<!-- Canonical URL: https://ask.atlascloud.ai/vi/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Hướng dẫn nhanh API Seedance 2.5: Tạo video đầu tiên của bạn với Atlas Cloud

> Hôm nay hãy triển khai tích hợp video Seedance hoạt động trên Atlas Cloud chỉ với một khóa API và hai lệnh gọi REST, sau đó thay thế bằng Seedance 2.5 khi ra mắt chỉ bằng cách thay đổi một chuỗi model.

Bạn đã đọc [thông báo về Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud), phác thảo một tính năng sản phẩm xoay quanh các clip được tạo dài 30 giây, và giờ bạn muốn viết mã. Rồi bạn đụng phải bức tường mà mọi nhà phát triển đều gặp khi làm việc với một mô hình vừa được công bố: trang thông tin về khả năng của mô hình đã có, nhưng điểm cuối (endpoint) mà bạn thực sự có thể gọi từ ứng dụng của mình lại là một câu hỏi hoàn toàn khác.

Đây là phiên bản trung thực của tình huống, và một hướng dẫn nhanh tôn trọng điều đó. Atlas Cloud đã xuất bản một trang họ mô hình [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5 cam kết truy cập Ngày 0 (Day-0) trên cùng các điểm cuối hợp nhất đã phục vụ [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) và 1.5. Tại thời điểm viết bài, mục này được gắn nhãn "Sắp phát hành" (Coming Soon) và chưa có giá nào của Atlas Cloud cho Seedance 2.5 được công bố. Điều này có nghĩa thực tế là một tin tốt: tích hợp bạn xây dựng hôm nay trên một bậc (tier) Seedance đang hoạt động chính là tích hợp bạn sẽ chạy khi 2.5 ra mắt. Điều duy nhất thay đổi là chuỗi tên mô hình.

Vì vậy, hướng dẫn nhanh này thực hiện hai việc. Nó cho bạn một video thực từ một điểm cuối thực tế ngay hôm nay, và nó cấu trúc mã và lời nhắc (prompt) của bạn để việc nâng cấp chỉ là một dòng lệnh khác biệt (one-line diff).

## Những gì thực sự được phát hành trong Seedance 2.5

Theo trang chính thức Seedance 2.5 của ByteDance, đây là mô hình tạo chung âm thanh-video thế hệ tiếp theo được xây dựng cho kể chuyện trong 30 giây với khả năng kiểm soát tham chiếu chính xác và chỉnh sửa mạnh mẽ. Các tuyên bố cụ thể đáng để thiết kế xung quanh:

* Lên đến 30 giây trong một lần tạo, với tùy chọn mở rộng thêm hai lần để kể chuyện dài hơn, hoàn chỉnh hơn
* Chuyển động mượt mà và nhất quán hơn, với hình ảnh chân thực hơn
* Hiểu video tham chiếu chính xác hơn, nắm bắt ý định, bố cục và ngôn ngữ điện ảnh thay vì chỉ chuyển giao chuyển động
* Chỉnh sửa đáng tin cậy hơn trên phạm vi rộng hơn các yêu cầu chỉnh sửa âm thanh và hình ảnh
* Điều khiển mô hình trắng (white-model) và chỉnh sửa màn hình xanh, cùng với chuyển động máy quay chuyên nghiệp và chặn hiệu suất (performance blocking), nhằm vào các quy trình sản xuất phức tạp

Lưu ý những gì không có trong danh sách đó: không có bảng điểm chuẩn, không có thang độ phân giải, không có số lượng tài sản tham chiếu. Bất cứ điều gì bạn thấy theo những hướng đó đều là lời quảng bá tiếp thị của ai đó, không phải bảng thông số kỹ thuật chính thức. Hãy xây dựng dựa trên các tuyên bố trên.

## Bước 1: lấy khóa từ bảng điều khiển (console)

Đăng nhập tại console.atlascloud.ai và tạo một khóa API. Không cần đặt cọc, không có cam kết tối thiểu và không có danh sách chờ, vì vậy khóa có thể sử dụng ngay lập tức theo hình thức trả tiền theo mức sử dụng (pay-as-you-go). Một khóa bao phủ toàn bộ danh mục hơn 300 mô hình trên văn bản, hình ảnh và video, trên một tài khoản thanh toán duy nhất, đó là phần quan trọng cho hướng dẫn nhanh này: khóa bạn tạo ngay bây giờ chính là khóa sẽ gọi Seedance 2.5 sau này.

Lưu trữ nó như một biến môi trường, không bao giờ trong mã nguồn. `ATLASCLOUD_API_KEY` là một tên phù hợp.

## Bước 2: gửi một công việc video

Tạo video trên Atlas Cloud là một cuộc gọi REST không đồng bộ hai bước, không phải là chat completion. Bạn gửi POST một công việc và nhận lại một ID dự đoán (prediction ID), sau đó bạn thăm dò (poll) ID đó cho đến khi kết xuất hoàn tất. Bất kỳ HTTP client nào cũng được, vì vậy không cần cài đặt SDK nhà cung cấp và không cần học sơ đồ xác thực mới: đó là một token Bearer trên khóa bạn vừa tạo.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

Phản hồi trả về dạng `{"code": 200, "data": {"id": "...", "status": "processing"}}`. Lưu ý rằng `model` là một trường chuỗi đơn giản. Chi tiết đó chính là toàn bộ câu chuyện nâng cấp cho bài viết này, và Bước 6 sẽ quay lại vấn đề này.

## Bước 3: thăm dò cho đến khi kết xuất hoàn thành

Một clip 5 giây không phải là một phản hồi tức thời, vì vậy hãy coi kết xuất như một công việc có vòng đời hơn là một cuộc gọi chặn (blocking). Thăm dò điểm cuối dự đoán cho đến khi `status` đạt đến giá trị cuối.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # on success the payload carries the output URL(s)
```

Có hai điều đáng để xây dựng ngay bây giờ thay vì sau này. Đặt một giới hạn tối đa cho vòng lặp thăm dò để một công việc bị kẹt không thể treo một trình xử lý yêu cầu, và lưu ID dự đoán trước khi bắt đầu thăm dò để một worker bị crash có thể tiếp tục thay vì phải trả tiền cho hai lần kết xuất. Cả hai thói quen này đều được giữ nguyên khi chuyển sang 2.5.

Nếu tính năng của bạn hoạt động từ một hình ảnh tham chiếu hoặc một tham chiếu chủ thể thay vì văn bản thuần túy, thì luồng tương tự áp dụng với một biến thể mô hình khác, `bytedance/seedance-2.0/image-to-video` hoặc `bytedance/seedance-2.0/reference-to-video`. Tài sản tham chiếu chủ thể được tải lên một lần thông qua `uploadMedia` và sau đó được truyền dưới dạng `asset://<id>` trong các trường hình ảnh, vì vậy một nhân vật hoặc sản phẩm lặp lại không cần tải lại mỗi lần gọi.

## Bước 4: chọn một bậc Seedance đang hoạt động và biết một giây có giá bao nhiêu

Atlas Cloud tính phí video theo giây thời lượng đầu ra. Đó là phép tính số học bạn có thể làm trong đầu trước khi viết bất kỳ mã nào. Ba bậc Seedance đang hoạt động hôm nay:

| Mô hình | ID mô hình | Giá Atlas Cloud | Ghi chú |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/s | Bậc chính đang hoạt động, khóa tức thì, không có danh sách chờ |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/s | Biến thể nhanh hơn của cùng họ |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/s | Bậc Seedance 2.0 đang hoạt động rẻ nhất, cũng có image-to-video và reference-to-video |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/s, hoặc $0.018/s trên biến thể Fast | Âm thanh đồng bộ gốc, đồng bộ môi đa ngôn ngữ, clip 4 đến 12 giây |

Để định hướng, các mô hình video khác trên cùng một khóa chạy trong một khoảng tương tự: Grok Imagine Video v1.5 ở $0.080/s, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) ở $0.100/s, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo ở $0.112 tiêu chuẩn và $0.095 giảm giá, MiniMax H3 ở $0.14/s.

Chọn cái nào để xây dựng phụ thuộc vào những gì tính năng 2.5 của bạn cuối cùng sẽ làm. Nếu âm thanh là trung tâm của đầu ra, Seedance 1.5 Pro là bậc đã có âm thanh đồng bộ gốc và đồng bộ môi đa ngôn ngữ, vì vậy đường ống của bạn học cách xử lý một bản nhạc âm thanh ngay từ ngày đầu. Nếu bạn đang lặp lại cấu trúc lời nhắc và muốn chi phí thấp nhất cho mỗi thử nghiệm, Seedance 2.0 Mini ở $0.056/s là sandbox rõ ràng. Nếu bạn muốn thứ gần giống nhất với một kết xuất cấp sản xuất thế hệ hiện tại, Seedance 2.0 ở $0.112/s là lựa chọn thẳng thắn, với biến thể Fast ở $0.09/s nếu thông lượng (throughput) quan trọng hơn mức tăng chất lượng cuối cùng.

## Bước 5: kiểm tra giá thực tế trong Playground trước khi bạn chi tiêu

Trước cuộc gọi trả phí đầu tiên của bạn, hãy mở mô hình trong Atlas Cloud Playground. Mỗi mô hình hiển thị giá trực tiếp theo mô hình bên cạnh nút Run. Điều này quan trọng hơn vẻ ngoài của nó: các ưu đãi khuyến mại đến và đi, và con số bên cạnh nút Run là con số thực sự sẽ được tính phí. Chạy một lần tạo trong Playground, xác nhận đầu ra là những gì tính năng của bạn cần, sau đó chuyển các cài đặt vào mã.

Mô hình tính phí theo giây trên đầu ra cũng làm cho cuộc trò chuyện ngân sách của bạn trở nên đơn giản. Một clip 10 giây trên Seedance 2.0 Mini là 10 × $0.056. Không cần máy tính, không cần ước tính token và không có bước đối chiếu sau đó.

Điều này đáng được so sánh với cách các kênh ByteDance chính thức tính phí Seedance. Trên Volcano Engine Ark ở Trung Quốc và BytePlus ModelArk quốc tế, tính phí dựa trên token: mức tiêu thụ token ước tính là (thời lượng video đầu vào + thời lượng video đầu ra) × chiều rộng đầu ra × chiều cao đầu ra × tốc độ khung hình đầu ra / 1024, nhân với giá đơn vị token, với mức sử dụng thực tế có thẩm quyền từ trường `usage.completion_tokens` trong phản hồi API. Đối với dòng Seedance 2.0 và Seedance 2.5, khi đầu vào bao gồm video, một mức sàn tiêu thụ token tối thiểu được áp dụng, và mức sàn phụ thuộc vào độ phân giải, tỷ lệ khung hình và thời lượng đầu ra. ByteDance xuất bản một máy tính giá cộng với một bảng token tối thiểu chính xác vì lý do này.

Cả hai mô hình đều hợp pháp. Nhưng nếu bạn đang lập ngân sách cho một kết xuất 30 giây, tính phí theo giây thời lượng đầu ra là phép tính số học trong đầu, trong khi token với mức sàn cần một bảng tính.

## Bước 6: viết mô tả cảnh quay như thể nó đã là 2.5

Đây là phần của hướng dẫn nhanh chuyển giao hoàn hảo, bởi vì nghệ thuật viết lời nhắc không có phiên bản. Hai trong số các tuyên bố về khả năng của 2.5 nên thay đổi cách bạn viết ngay hôm nay.

**Kiểm soát tham chiếu chính xác.** Tuyên bố của ByteDance là 2.5 đọc một video tham chiếu để tìm ý định, bố cục và ngôn ngữ điện ảnh của nó, vượt xa việc chuyển giao chuyển động. Hàm ý về lời nhắc là tài sản tham chiếu của bạn không còn là một mẫu chuyển động và bắt đầu trở thành một bản tóm tắt đạo diễn. Vì vậy, hãy ngừng viết những lời nhắc chỉ mô tả chủ thể, và bắt đầu đặt tên cho ngữ pháp bạn muốn được chuyển giao: cảm giác ống kính, bố cục, nhịp điệu của cắt, máy quay dẫn trước hay theo sau chủ thể. Viết "handheld, subject-following medium shot, slight lag on turns" thay vì "person walking, cinematic".

**Ba mươi giây trong một lần tạo.** Một clip 5 giây là một cảnh quay. Ba mươi giây là một cảnh có cấu trúc, và 2.5 hỗ trợ mở rộng hai lần trên đó. Vì vậy, hãy viết mô tả cảnh quay với một cấu trúc nhịp điệu (beat structure) thay vì một mô tả tĩnh duy nhất: một nhịp thiết lập, một sự thay đổi (một ngã rẽ, một lối vào, một tiết lộ), và một giải pháp. Đặt tên chuyển động máy quay và chặn hiệu suất một cách rõ ràng, vì đó chính xác là những điều khiển mà 2.5 hướng tới. Chủ thể đứng ở đâu, họ di chuyển đi đâu, máy quay làm gì trong khi họ di chuyển.

Cả hai thói quen đều có hiệu quả trên các bậc đang hoạt động ngay bây giờ. Cả hai đều là những thói quen chính xác mà 2.5 sẽ khen thưởng.

## Bước 7: lên kế hoạch cho việc chuyển đổi

Cấu trúc mã của bạn sao cho định danh mô hình là cấu hình, không phải là một hằng số chữ. Một hằng số, đọc từ môi trường hoặc cấu hình:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Sau đó truyền `SEEDANCE_MODEL` ở nơi Bước 2 đã hardcode chuỗi. Bởi vì `model` là một trường chuỗi JSON duy nhất trong thân `generateVideo`, việc nâng cấp tại thời điểm ra mắt 2.5 thực sự là một biến môi trường. Không phải là một phép ẩn dụ cho một thay đổi nhỏ, mà theo nghĩa đen là một giá trị.

Không bao giờ hardcode một định danh Seedance 2.5 ngay hôm nay, bởi vì chưa có ID mô hình Seedance 2.5 nào của Atlas Cloud tồn tại. Lấy các ID thực tế đang hoạt động từ danh mục tại atlascloud.ai/models thay vì sao chép từ một bài viết, bao gồm bài này, vì các biến thể mới được thêm vào theo thời gian. Khi 2.5 ra mắt theo cam kết Ngày 0, công việc của bạn là biến đó, cộng với một cái nhìn mới về giá bên cạnh nút Run và đọc lại bất kỳ tham số yêu cầu mới nào, vì một mô hình 30 giây với hỗ trợ mở rộng có thể sẽ chấp nhận các trường mà thân 2.0 không có.

Trong khi chờ đợi, nếu bạn cần Seedance 2.5 ngay hôm nay thay vì khi ra mắt Atlas Cloud, câu trả lời trung thực là các kênh ByteDance chính thức: Volcano Engine Ark ở Trung Quốc và BytePlus ModelArk quốc tế. Trong số các nhà tổng hợp (aggregators), một số đang ở cùng trạng thái tiền ra mắt hoặc cam kết Ngày 0.

## FAQ

**Hỏi:** Tôi có thể gọi Seedance 2.5 trên Atlas Cloud ngay bây giờ không?
**Đáp:** Không. Trang họ mô hình Seedance 2.5 trên Atlas Cloud được đánh dấu "Sắp phát hành" với cam kết truy cập Ngày 0 trên cùng các điểm cuối hợp nhất đã phục vụ Seedance 2.0 và 1.5. Chưa có ID mô hình và giá nào được công bố cho nó.

**Hỏi:** Seedance có giá bao nhiêu trên Atlas Cloud ngay hôm nay?
**Đáp:** Seedance 2.0 là $0.112/s, Seedance 2.0 Fast là $0.09/s, Seedance 2.0 Mini là $0.056/s, và Seedance 1.5 Pro là $0.047/s hoặc $0.018/s trên biến thể Fast của nó. Thanh toán theo giây thời lượng đầu ra, và giá thực tế được hiển thị bên cạnh nút Run trong Playground.

**Hỏi:** Tôi có cần SDK đặc biệt cho video trên Atlas Cloud không?
**Đáp:** Không. Video là một luồng REST đơn giản: `POST /api/v1/model/generateVideo` để gửi công việc, sau đó `GET /api/v1/model/prediction/{id}` để thăm dò, cả hai đều được xác thực bằng token Bearer trên khóa Atlas Cloud của bạn. Bất kỳ HTTP client nào cũng hoạt động. Lưu ý rằng video không đi qua điểm cuối chat tương thích OpenAI mà danh mục văn bản sử dụng, vì vậy đừng mong đợi `chat.completions` sẽ kết xuất một clip. Các tham số yêu cầu theo mô hình được tài liệu hóa tại atlascloud.ai/docs.

**Hỏi:** Có cần đặt cọc hoặc cam kết tối thiểu để bắt đầu không?
**Đáp:** Không. Atlas Cloud là hình thức trả tiền theo mức sử dụng, không cần đặt cọc, không cam kết tối thiểu và không có danh sách chờ, và khóa từ console.atlascloud.ai có thể sử dụng ngay lập tức.

**Hỏi:** Tôi nên xây dựng nguyên mẫu trên bậc nào nếu tôi đang nhắm đến 2.5?
**Đáp:** Seedance 2.0 Mini ở $0.056/s để lặp lại lời nhắc giá rẻ, Seedance 1.5 Pro nếu đường ống của bạn cần xử lý một bản nhạc âm thanh đồng bộ gốc, và Seedance 2.0 ở $0.112/s để có kết xuất sản xuất thế hệ hiện tại gần nhất.

## Kết luận

Atlas Cloud chạy Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini và Seedance 1.5 Pro ngay hôm nay trên một khóa API duy nhất với tính phí theo giây thời lượng đầu ra, chứng nhận SOC II, tuân thủ HIPAA và mã hóa khi lưu trữ và truyền tải, và đã xuất bản cam kết Ngày 0 để phục vụ Seedance 2.5 trên cùng các điểm cuối hợp nhất đó khi nó được phát hành.

Để có hướng dẫn triển khai liên quan, hãy xem [các API hình ảnh, video và LLM mới nhất hiện có](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) và [ước tính năng lực suy luận AI, độ trễ và chi phí](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).