Xây dựng trên các REST endpoint được host tại www.seedance2.ink để dùng Seedance 2.0, Seedance 2.0 Fast và Seedance 1.5 Pro. API theo mô hình tác vụ bất đồng bộ và hỗ trợ cả prompt văn bản thuần túy lẫn yêu cầu có hình ảnh dẫn hướng.
Tạo API key trong bảng điều khiển, gửi yêu cầu tới https://www.seedance2.ink/api/open/v1, và dùng polling hoặc webhooks để nhận kết quả.
1. Lấy API key của bạn
Sau khi đăng ký, vào bảng điều khiển để tạo API key riêng của bạn.
2. Gửi tác vụ tạo
Gửi prompt và phần media lên API, rồi nhận requestId ngay lập tức.
3. Theo dõi trạng thái và lấy kết quả
Poll endpoint trạng thái để theo dõi tiến trình và lấy video đã tạo khi sẵn sàng.
API công khai của chúng tôi được xây dựng trên cùng luồng tạo đang vận hành ứng dụng web, nay được mở ra dưới dạng endpoint ổn định và thân thiện với nhà phát triển.
Giá được tính theo từng giây video tạo ra và thay đổi theo model và độ phân giải.
| Mô hình | 480p | 720p | 1080p |
|---|---|---|---|
| Seedance 2.0 | $0.050/s | $0.100/s | $0.200/s |
| Seedance 2.0 Fast | $0.040/s | $0.080/s | $0.160/s |
| Seedance 1.5 Pro | $0.020/s | $0.040/s | $0.080/s |
Ví dụ: một tác vụ Seedance 2.0 dài 5 giây ở 720p có giá $0.50, tương đương 40 credits với mức $0.0125 mỗi credit.
curl -X POST https://www.seedance2.ink/api/open/v1/video/generations \
-H "Authorization: Bearer sd2_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "A neon-lit alley in heavy rain, cinematic tracking shot",
"mediaUrls": [
"https://example.com/reference/start-frame.jpg"
],
"aspectRatio": "16:9",
"duration": 5,
"resolution": "720p",
"webhookUrl": "https://your-app.com/webhooks/seedance",
"metadata": {
"orderId": "demo_1001"
}
}'curl https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890 \
-H "Authorization: Bearer sd2_live_your_api_key"
{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"model": "seedance-2.0",
"prompt": "A neon-lit alley in heavy rain, cinematic tracking shot",
"duration": 5,
"aspectRatio": "16:9",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}Mỗi yêu cầu tạo video được xử lý như một tác vụ bất đồng bộ với vòng đời rõ ràng và có thể dự đoán.
queued: yêu cầu đã được chấp nhận và đang chờ xử lý ở upstream.
processing: job của model đang chạy và video cuối chưa sẵn sàng.
succeeded / failed / cancelled: tác vụ đã kết thúc, và bạn có thể lấy đầu ra cuối hoặc payload lỗi.
Khi phát triển cục bộ, polling là cách dễ nhất. Nếu muốn ứng dụng nhận callback hoàn tất tự động, hãy đặt webhookUrl.
Bề mặt API hiện tại được giữ rất gọn: một endpoint tạo, một endpoint trạng thái và một endpoint danh sách model.