Lấy Task (Tương thích Volc)

Tổng quanCopy Anchor Link

Sử dụng ID cgt-... được trả về từ lệnh create. Hãy thực hiện polling mỗi vài giây trong khi task ở trạng thái queued hoặc running. Dừng lại khi task ở trạng thái succeeded, failed, cancelled, hoặc expired.

Xem thêm Mô hình video Seedance 2.0 và Tạo Video.

Các giá trị trạng tháiCopy Anchor Link

• 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 đã xuất hiện.
• failed: quá trình tạo thất bại; hãy kiểm tra error.code và error.message.
• cancelled: task đã bị hủy trước khi hoàn thành.
• expired: task đã hết hạn trước khi hoàn thành.

Các trường phản hồiCopy Anchor Link

• id: ID task tương thích, bắt đầu bằng cgt-.
• model: định danh model được phản hồi lại để đảm bảo tính tương thích.
• 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.
• content.last_frame_url: chỉ xuất hiện khi được yêu cầu và khả dụng.
• usage: mức sử dụng token khi khả dụng.
• created_at và updated_at: dấu thời gian của task.
• error: Chi tiết lỗi tùy chọn khi có. Xem error.code và error.message; không suy ra sự hiện diện của trường chỉ từ status.

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.

Ví dụCopy Anchor Link

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

{
  "id": "cgt-20260102030405-a1b2c",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/result.mp4"
  },
  "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}