Đối tác chính thức của BytePlusBytePlus, một công ty thuộc ByteDance
API cho nhà phát triển · Đối tác chính thức của BytePlus
Seedance 2.0 API và Seedream API
Tạo video bằng Seedance 2.0 và ảnh bằng Seedream ngay trong mã của bạn. Xây dựng trên BytePlus, một công ty thuộc ByteDance. Một khóa API, token trả trước $0.05 mỗi token, tải tệp lên, webhook có chữ ký và yêu cầu idempotent.
- Endpoint REST /v1
- 1 token = $0.05
- Webhook
- Idempotency-Key
- Seedance 2.0 tới 4K
Cập nhật lần cuối:
Trong trang này
Seedance API và Seedream API không cần thiết lập
Nhà phát triển tìm Seedance API, Seedream API hay BytePlus API thường muốn cùng một điều: gửi câu lệnh cùng vài tệp tham chiếu, nhận lại video hay ảnh hoàn chỉnh, và chỉ trả cho phần đã dùng. API cho nhà phát triển của KreatorFlow hoạt động đúng như vậy. Dùng các mô hình Seedance 2.0 và Seedream của ByteDance qua BytePlus, một công ty thuộc ByteDance, gọi qua một bộ endpoint REST gọn nhẹ dưới /v1.
Mô hình video có bí danh ổn định (kreator-video-fast, kreator-video-seedance-2-fast, kreator-video-mini, kreator-video-seedance-2-mini, kreator-video-pro, kreator-video-seedance-2, kreator-video-seedance-2-5, kreator-video-wan-3, kreator-video-wan-3-prime, kreator-video-kling-3, kreator-video-kling-3-omni, kreator-video-kling-3-turbo và kreator-video-kling-4), mô hình ảnh là kreator-image-fast, kreator-image-pro, kreator-image-wan-2-7-pro, kreator-image-wan-2-6, kreator-image-seedream-5-pro và kreator-image-seedream-5-flash. GET /v1/models trả về độ dài, tỉ lệ khung hình, độ phân giải và giới hạn tham chiếu của từng bí danh, nên bạn đọc giới hạn từ đó thay vì ghi cứng trong mã. Seedance 2.0 tạo clip từ 4 đến 15 giây ở 720p, 1080p và 4K, mỗi tác vụ dùng tối đa 9 ảnh, 3 clip và 3 đoạn âm thanh làm tham chiếu. Seedance 2.5 tạo clip dài tới 30 giây ở 720p, 1080p và 4K.
Endpoint
POST /v1/videos
Tác vụ video Seedance: từ văn bản, từ ảnh, khung đầu và khung cuối, hoặc video có tham chiếu.
POST /v1/video-edits
Chỉnh sửa, đổi phong cách, biến đổi hoặc kéo dài clip của bạn hay clip bạn có quyền dùng.
POST /v1/images
Tạo và chỉnh sửa ảnh Seedream từ câu lệnh, ảnh tham chiếu và nhân vật.
POST /v1/uploads
Tạo lượt tải lên, gửi tệp bằng PUT rồi truyền ID tải lên làm tham chiếu. Không cần lưu trữ công khai.
POST /v1/characters
Đăng ký một lần nhân vật dùng lại nhiều lần, sau đó truyền ID vào character_ids của tác vụ ảnh và video.
GET /v1/jobs/{job_id}
Hỏi trạng thái và lấy kết quả. Bạn cũng có thể nhận cùng nội dung đó qua webhook.
Bắt đầu ngay với curl
Tạo một tác vụ Seedance 2.0, rồi hỏi trạng thái hoặc chờ webhook.
curl https://kreatorflow.ai/v1/videos \
-H "Authorization: Bearer $KREATORFLOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: launch-teaser-001" \
-d '{
"model": "kreator-video-seedance-2",
"prompt": "slow dolly in on a glass perfume bottle, soft studio light",
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p",
"webhook_url": "https://example.com/hooks/kreatorflow"
}'
curl https://kreatorflow.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $KREATORFLOW_API_KEY"Tạo khóa trong bảng điều khiển API, xuất ra dưới tên KREATORFLOW_API_KEY và chỉ giữ nó trên máy chủ. Tài liệu tham khảo đầy đủ kèm ví dụ Node và Python có trong tài liệu cho nhà phát triển (tiếng Anh).
Giá token
Mỗi token $0.05. Giá được tính trước khi tác vụ được nhận và trừ vào số dư trả trước.
Ảnh Seedream 5.0 Lite
1
token · $0.05 · kreator-image-fast
Ảnh Seedream 4.5
2
token · $0.10 · kreator-image-pro
Seedance 2.0 Mini, 720p 5 giây
7
token · $0.35 · kreator-video-mini
Ảnh Seedream 5.0 Flash
1
token · $0.05 · kreator-image-seedream-5-flash
Ảnh Seedream 5.0 Pro
2
token · $0.10 · kreator-image-seedream-5-pro
Seedance 2 Fast, 720p 5 giây
9
token · $0.45 · kreator-video-fast
Seedance 2.0, 720p 5 giây
11
token · $0.55 · kreator-video-pro
Seedance 2.0, 1080p 5 giây
24
token · $1.20 · kreator-video-pro
Seedance 2.0, 4K 5 giây
58
token · $2.90 · kreator-video-pro
Seedance 2.5, 720p 5 giây
21
token · $1.05 · kreator-video-seedance-2-5
Seedance 2.5, 1080p 30 giây
267
token · $13.35 · kreator-video-seedance-2-5
Nạp bằng thẻ trong bảng điều khiển, mỗi lần từ $20 đến $5,000. Token API được tính bằng đô la Mỹ. Không có phí hằng tháng hay gói đăng ký, và token giữ chỗ cho tác vụ lỗi được trả về số dư. Giá mỗi clip so với các Seedance API khác có trên trang so sánh giá Seedance API.
Những gì KreatorFlow API lo giúp bạn
- Seedance 2.5, Seedance 2.0, Seedance 2 Fast, Seedance 2.0 Mini và Seedream với một khóa KreatorFlow có thể phân quyền.
- Token trả trước, nạp bằng thẻ, không cần gói đăng ký.
- ID tải lên giới hạn trong không gian làm việc của bạn, nên tham chiếu không cần URL công khai.
- Ảnh tham chiếu được chuẩn bị sẵn trong thư viện tệp tin cậy trước khi gửi đi.
- Webhook có chữ ký cho job.completed, job.failed, job.canceled và job.blocked.
- Hỗ trợ Idempotency-Key: gửi lại cùng yêu cầu sẽ trả về tác vụ ban đầu thay vì tạo bản trùng.
- Token giữ chỗ được trả lại khi tác vụ lỗi.
- Nhân vật dùng lại nhiều lần và chỉnh sửa video gốc qua các endpoint đơn giản.
Bắt đầu trong ba bước
- 1
Tạo tài khoản và khóa
Đăng nhập bảng điều khiển API tại developers.kreatorflow.ai và tạo một khóa API.
- 2
Nạp token
Nạp từ $20 trở lên trong tab Billing. Mọi khóa trong tài khoản dùng chung số dư.
- 3
Gửi tác vụ đầu tiên
Gọi POST /v1/videos hoặc POST /v1/images kèm Idempotency-Key, rồi hỏi trạng thái hoặc nhận webhook.
Quy định sử dụng
API tuân theo cùng Chính sách sử dụng (tiếng Anh) với studio. Tệp tham chiếu phải do bạn tạo hoặc bạn có quyền sử dụng. Nếu muốn tự tay tạo thay vì viết mã, bạn có thể dùng cùng mô hình trong trình tạo video Seedance 2.0.
Câu hỏi thường gặp về Seedance API
Đây có phải Seedance API chính hãng không?
Đây là API riêng của KreatorFlow, xây dựng trên BytePlus, một công ty thuộc ByteDance. KreatorFlow là đối tác chính thức của BytePlus, một công ty thuộc ByteDance; yêu cầu đi qua BytePlus tới Seedance 2.0 và Seedream, và bạn dùng chúng bằng các bí danh mô hình ổn định của KreatorFlow với một khóa KreatorFlow duy nhất.
Seedance 2.0 API giá bao nhiêu?
Bạn trả bằng token trả trước, mỗi token $0.05. Một clip Seedance 2.0 dài 5 giây ở 720p tốn 11 token; cùng độ dài, Seedance 2 Fast tốn 9 token, Seedance 2.0 Mini tốn 7 token, còn một ảnh Seedream 4.5 tốn 2 token. Mỗi lần nạp từ $20 đến $5,000.
Seedream API có dùng ảnh tham chiếu được không?
Có. Tải ảnh lên bằng POST /v1/uploads rồi truyền ID tải lên làm ảnh tham chiếu, hoặc gửi một URL HTTPS công khai. kreator-image-pro (Seedream 4.5) nhận tối đa 14 ảnh tham chiếu, còn nhân vật dùng lại nhiều lần thì đăng ký một lần bằng POST /v1/characters.
Tôi nhận webhook hay phải hỏi trạng thái liên tục?
Cả hai đều được. Thêm webhook_url vào yêu cầu tạo để nhận các sự kiện job.completed, job.failed, job.canceled và job.blocked, mỗi sự kiện được ký bằng X-KreatorFlow-Signature tạo từ secret trong tab Webhooks. Hoặc hỏi trạng thái bằng GET /v1/jobs/{job_id}.
Nếu tác vụ bị lỗi thì sao?
Token được giữ chỗ khi tác vụ bắt đầu và được trả lại nếu tác vụ lỗi, hết thời gian hoặc bị từ chối trước khi gửi đi. Bạn không trả tiền cho tác vụ lỗi. Gửi lại yêu cầu với cùng Idempotency-Key sẽ trả về tác vụ ban đầu thay vì tạo tác vụ trùng, nên gửi lại khi mạng chập chờn là an toàn. Khi muốn thử lần mới, hãy dùng khóa mới.
Xây dựng với Seedance 2.0 API
Tạo khóa, nạp token, và chỉ vài phút sau bạn đã gửi được tác vụ Seedance hay Seedream đầu tiên.