Seedance API: tạo video đầu tiên chỉ với ba lần gọi
Tạo job video Seedance, kiểm tra trạng thái và tải file MP4 bằng HTTP thuần. Hướng dẫn đầy đủ với curl và Python, kèm chi phí của từng bước.

Model video không trả lời trong một request như model chat. Một video mất từ một đến năm phút để tạo, nên API chạy nó dưới dạng job: bạn khởi tạo job, kiểm tra trạng thái, rồi tải file khi xong. Bài này đi qua cả ba lần gọi với một model Seedance, trước tiên bằng curl, sau đó bằng một script Python ngắn.
Bạn cần một tài khoản API Store có số dư và một API key lấy từ trang API key. Key bắt đầu bằng sk-.
Bước 1: khởi tạo job
Gửi model, prompt và, nếu muốn, độ dài, độ phân giải và tỉ lệ khung hình tới POST /videos:
curl https://api.apistore.cloud/v1/videos \
-H "Authorization: Bearer $APISTORE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
"ratio": "16:9"
}'Response trả về ngay. Nó chứa id của job và trạng thái:
{ "id": "video_8f2c...", "status": "queued", "model": "seedance-2.0-mini" }Nếu bỏ các trường không bắt buộc, bạn nhận video 5 giây, 720p, tỉ lệ 16:9, có âm thanh. Âm thanh (lời nói, nhạc và hiệu ứng) được tạo cùng lúc với hình; gửi "audio": false nếu bạn không cần.
Bước 2: hỏi trạng thái cho đến khi xong
Cứ vài giây lại hỏi job một lần:
curl https://api.apistore.cloud/v1/videos/video_8f2c... \ -H "Authorization: Bearer $APISTORE_API_KEY"
status chuyển từ queued sang in_progress, rồi kết thúc ở completed hoặc failed. Job hoàn thành còn có usage.video_tokens và usage.cost_usd, nên bạn biết chính xác chi phí. Job lỗi có error.code và error.message và không bị tính phí.
Bước 3: tải file
Job hoàn thành có url: link tới file MP4, dùng được trong một tuần và được gia hạn mỗi lần bạn đọc job. Bạn cũng luôn tải được file qua API:
curl -L https://api.apistore.cloud/v1/videos/video_8f2c.../content \ -H "Authorization: Bearer $APISTORE_API_KEY" -o boat.mp4
Làm tương tự bằng Python
Không cần SDK: chỉ cần package requests.
import os, time, requests
BASE = "https://api.apistore.cloud/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APISTORE_API_KEY']}"}
job = requests.post(f"{BASE}/videos", headers=HEAD, json={
"model": "seedance-2.0-mini",
"prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
"seconds": 5,
"resolution": "720p",
}).json()
while job["status"] not in ("completed", "failed"):
time.sleep(5)
job = requests.get(f"{BASE}/videos/{job['id']}", headers=HEAD).json()
if job["status"] == "failed":
raise SystemExit(f"{job['error']['code']}: {job['error']['message']}")
video = requests.get(f"{BASE}/videos/{job['id']}/content", headers=HEAD)
open("boat.mp4", "wb").write(video.content)
print("cost", job["usage"]["cost_usd"], "USD")Chi phí bao nhiêu
Video được tính phí theo phần video model thực sự tạo ra. Giá phụ thuộc vào model và độ phân giải, và trang web hiển thị giá theo mỗi giây video đầu ra. Seedance 2.0 mini ở 480p, tổ hợp rẻ nhất hiện nay, có giá 0,0202 US$ mỗi giây, và 0,0454 US$ mỗi giây ở 720p.
Khi job bắt đầu, chi phí của kết quả dài nhất mà job có thể tạo ra được tạm giữ từ số dư của bạn. Khi job xong, bạn trả cho phần đã tạo và phần còn lại được hoàn về. Nếu job lỗi, bạn không bị tính phí. Bài cách tính phí video giải thích chi tiết các con số.
Nên bắt đầu với model nào
- Seedance 2.0 mini để thử nghiệm và làm bản nháp: giá thấp nhất, 480p và 720p.
- Seedance 2.0 fast khi bạn muốn chất lượng tốt hơn với giá vừa phải.
- Seedance 2.0 cho hình ảnh đẹp nhất trong dòng 2.0, tối đa 1080p và 4K.
- Seedance 2.5 cho video dài tới 30 giây, nhiều file tham chiếu, và chỉnh sửa hoặc kéo dài video.
Cả bốn model nhận cùng một request, nên bạn đổi model chỉ bằng một từ. Bài chọn model Seedance so sánh chúng cạnh nhau.
Bước tiếp theo
- Đưa cho model khung hình đầu hoặc ảnh tham chiếu: xem tài liệu video.
- Thử prompt trong playground trước khi viết code.
- Xem bảng giá của mọi model và độ phân giải.

