取得任務 (Volc 相容)

概覽Copy Anchor Link

使用建立時回傳的 cgt-... ID。當任務狀態為 queued 或 running 時，請每隔幾秒進行輪詢。當任務狀態變為 succeeded、failed、cancelled 或 expired 時停止輪詢。

請參閱 Seedance 2.0 影片模型 與 影片生成。

狀態值Copy Anchor Link

• queued: 已接受並等待執行。
• running: 正在生成中。
• succeeded: 結果已就緒，且 content.video_url 存在。
• failed: 生成失敗；請檢查 error.code 和 error.message。
• cancelled: 任務在完成前已被取消。
• expired: 任務在完成前已過期。

回應欄位Copy Anchor Link

• id: 相容性任務 ID，以 cgt- 開頭。
• model: 為相容性而回傳的模型識別碼。
• status: 上述狀態值之一。
• content.video_url: 成功時的最終影片 URL。
• content.last_frame_url: 僅在請求且可用時提供。
• usage: 可用時的 token 使用量。
• created_at 與 updated_at: 任務時間戳記。
• error: 選用的錯誤詳情。有值時查看 error.code 和 error.message，不要僅依 status 推斷此欄位是否存在。

回應中絕不會包含 TokenLab 的欄位，例如 progress、return_last_frame、watermark、priority 或 camera_fixed。

範例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}