TokenLab

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ó.

GET
/api/v3/contents/generations/tasks/{id}

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 tra error.code và 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ằng cgt-.
  • model: giá trị model bạ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_tokens và total_tokens khi có sẵn, cộng với tool_usage.web_search khi công cụ tìm kiếm web đã chạy.
  • created_at và 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ên status.
  • 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, frames và 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
  }
}
Go
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
AuthorizationBearer <token>

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*string

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