Video & tư liệu
Lấy Tác vụ (Tương thích Volc)
Lấy tác vụ tương thích Seedance theo ID tác vụ cgt của nó.
Tổng quan
Sử dụng ID cgt-... được trả về từ quá trình tạo. Hãy thực hiện polling (truy vấn định kỳ) vài giây một lần khi tác vụ đang ở trạng thái queued hoặc running. Dừng lại khi tác vụ ở trạng thái succeeded, failed, cancelled hoặc expired.
Không sử dụng lại enum tác vụ hoặc cấu trúc phản hồi v1 thống nhất ở đây. /v1/tasks/{id} sử dụng pending, processing, completed và failed; endpoint v3 này sử dụng enum chính thức ở trên. Trong đối tượng JSON v3, duration là một chuỗi khi có mặt và error là tùy chọn, chứa chi tiết lỗi khi có sẵn. Một Go client nghiêm ngặt nên khai báo Duration là string với thẻ JSON duration,omitempty và dừng lại ở mọi trạng thái kết thúc của v3.
Xem thêm Mô hình video Seedance 2.0 và Tạo Video.
Các Giá trị Trạng thái
queued: đã chấp nhận và đang chờ chạy.running: quá trình tạo đang diễn ra.succeeded: kết quả đã sẵn sàng vàcontent.video_urlđã có mặt.failed: quá trình tạo thất bại; hãy kiểm traerror.codevàerror.message.cancelled: tác vụ đã bị hủy trước khi hoàn thành.expired: tác vụ đã hết hạn trước khi hoàn thành.
Các Trường Phản hồi
id: ID tác vụ tương thích, bắt đầu bằngcgt-.model: giá trịmodelbạn đã gửi khi tạo tác vụ.status: một trong các giá trị trạng thái ở trên.content.video_url: URL video cuối cùng khi thành công. Đây là liên kết kết quả của TokenLab có hiệu lực trong 30 ngày; xem Lưu giữ dữ liệu.content.last_frame_url: chỉ xuất hiện khi được yêu cầu và có sẵn.usage:completion_tokensvàtotal_tokenskhi có sẵn, cộng vớitool_usage.web_searchkhi công cụ tìm kiếm web đã chạy.created_atvàupdated_at: Dấu thời gian Unix tính bằng giây.error:{ code, message }khi có sẵn chi tiết lỗi. Đừng suy luận sự hiện diện của nó chỉ dựa trênstatus.- Các giá trị yêu cầu được thiết lập cho tác vụ sẽ được phản hồi lại khi có sẵn:
seed,resolution,ratio,duration(chuỗi),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,framesvàframespersecond.
Phản hồi không bao giờ thêm các trường TokenLab như progress, return_last_frame, watermark, priority hoặc camera_fixed.
Một ID tác vụ không xác định hoặc đã hết hạn sẽ trả về 404; một ID thuộc về tổ chức khác sẽ trả về 403.
Ví dụ
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
-H "Authorization: Bearer $TOKENLAB_API_KEY"{
"id": "cgt-20260102030405-a1b2c",
"model": "seedance-2.0",
"status": "succeeded",
"content": {
"video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
},
"usage": {
"completion_tokens": 123456
}
}type SeedanceTask struct {
ID string `json:"id"`
Status string `json:"status"`
Duration string `json:"duration,omitempty"`
}
func isTerminal(status string) bool {
switch status {
case "succeeded", "failed", "cancelled", "expired":
return true
default:
return false
}
}curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"{ "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0}Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Tham số đường dẫn
ID tác vụ tương thích được trả về bởi endpoint tạo. Các ID bắt đầu bằng cgt-.
Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json