Video — Draft mode (bản nháp)
1.
POST /video với draft: true.2.
POST /video/{publicId}/finalize để tạo bản chính thức 1080p.Model hỗ trợ: chỉ Dreamina Seedance 2.5.
1. Tạo bản nháp — POST /video
draft.Tham số mới trong body
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
draft | boolean | Không | true để tạo bản nháp. Chỉ dùng được với Dreamina Seedance 2.5 và resolution = 480p (1). Mặc định false. |
Điều kiện
partnerModelId phải là model Dreamina Seedance 2.5.resolution phải là 480p (1).Chi ph í
Ví dụ
publicId để finalize về sau.Lỗi
| HTTP | message | Nguyên nhân |
|---|---|---|
| 400 | Draft mode is only supported by Dreamina Seedance 2.5. | partnerModelId không phải Seedance 2.5 |
| 400 | Draft mode requires resolution 480p. | resolution khác 480p |
2. Tạo bản chính thức — POST /video/{publicId}/finalize
publicId riêng. Bạn theo dõi video mới này như mọi video khác: qua GET /video/{publicId} hoặc webhook.Headers
| Header | Giá trị |
|---|---|
apikey | API key của bạn |
Content-Type | application/json |
Path parameter
| Tham số | Mô tả |
|---|---|
publicId | publicId của bản nháp |
Body
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
webHookUrl | string (URL http/https) | Không | URL nhận webhook cho bản chính thức. Nếu bỏ trống, hệ thống dùng webHookUrl của bản nháp. |
{}.Điều kiện
draft: true;status = 2, success);Chi phí
Ví dụ
Response (thành công)
{
"id": "09109249-8fa5-4857-a488-9946f124957e",
"publicId": "09109249-8fa5-4857-a488-9946f124957e",
"name": "Paper boat",
"status": 0,
"statusText": "pending",
"url": "",
"thumbnailUrl": "",
"createdDate": "2026-10-05T02:36:14.523Z",
"webHookUrl": "https://your-domain.com/webhooks/coco",
"draftOf": "d607b6bd-ca38-4866-aaaf-e33f922886b3"
}| Trường | Mô tả |
|---|---|
publicId | ID của bản chính thức (video mới) |
draftOf | publicId của bản nháp được dùng để tạo video này |
status / statusText | Trạng thái của bản chính thức, bắt đầu từ 0 / pending |
webHookUrl | URL sẽ nhận webhook khi bản chính thức hoàn tất |
Lỗi
[{"name": "...", "code": "...", "message": "..."}].message | Nguyên nhân |
|---|---|
Video not found. | publicId không tồn tại hoặc không thuộc công ty của bạn |
This video was not created in Draft mode. | Video không phải bản nháp |
Draft video is not ready yet. | Bản nháp chưa hoàn thành, hãy thử lại sau |
Draft video failed, cannot finalize. | Bản nháp đã thất bại |
This draft has already been finalized. | Bản nháp đã được finalize trước đó |
This draft has expired (older than 7 days) and can no longer be finalized. | Bản nháp đã quá 7 ngày |
This draft was created with a model version that has since changed and can no longer be finalized. Please create a new draft. | Model đã được nâng cấp sau khi tạo bản nháp; hãy tạo bản nháp mới |
Insufficient account balance. | Số dư không đủ cho video 1080p |
webHookUrl must be a valid http(s) URL | webHookUrl sai định dạng |
3. Trường mới khi xem video
GET /video/{publicId} và GET /video (danh sách) có thêm hai trường:| Trường | Kiểu | Mô tả |
|---|---|---|
draft | boolean | true nếu video là bản nháp |
finalized | boolean | true nếu bản nháp đã được dùng để tạo bản chính thức |
{
"publicId": "d607b6bd-ca38-4866-aaaf-e33f922886b3",
"status": 2,
"statusText": "success",
"draft": true,
"finalized": true
}Luồng sử dụng đề xuất
1.
POST /video với draft: true, resolution: 1, và lưu publicId của bản nháp.2.
GET /video/{publicId} cho tới khi status = 2).3.
url).4.
POST /video/{draftPublicId}/finalize, và lưu publicId mới.5.
publicId mới.Modified at 2026-10-23 05:17:08