Getting StartedLast Updated 2026-09-30

Task Query

On this page

ProcessMedia로 제출한 영상/오디오 태스크는 DescribeTaskDetail로, ProcessImage로 제출한 이미지 태스크는 DescribeImageTaskDetail로 상태와 결과를 조회합니다.

API 정보

항목	값
서비스	MPS
API Action	`DescribeTaskDetail`(영상/오디오), `DescribeImageTaskDetail`(이미지)
엔드포인트	`mps.tencentcloudapi.com`
API 버전	`2019-06`-12
처리 방식	동기

인증은 모든 API가 공통으로 TC3-HMAC-SHA256(SecretId/SecretKey) 서명을 사용합니다. 서명 생성 방법은 Quick Start의 TokenHub 문서를 참고하세요.

요청 파라미터

파라미터	타입	필수	예시	설명
TaskId	String	필수	`1250017490-20260318152230-abcdef123456`	조회할 태스크 ID. `ProcessMedia` 또는 `ProcessImage` 응답에서 발급된 값

응답 파라미터

파라미터	타입	필수	예시	설명
TaskType	String	항상	`WorkflowTask`	태스크 유형
Status	String	항상	`FINISH`	태스크 상태. `WAITING`(대기) / `PROCESSING`(처리 중) / `FINISH`(완료)
CreateTime	String	항상	`2026-03-18T15:22:30+08:00`	태스크 생성 시각
BeginProcessTime	String	처리 시작 후	`2026-03-18T15:22:35+08:00`	처리 시작 시각
FinishTime	String	완료 후	`2026-03-18T15:30:02+08:00`	처리 완료 시각
MediaProcessResultSet	Array of Object	해당 시	-	트랜스코딩 등 미디어 처리 서브태스크 결과. 출력 파일 경로 포함
AiAnalysisResultSet	Array of Object	해당 시	-	AI 분석 서브태스크 결과. 이해/하이라이트/변환 등 결과 포함
AiQualityControlTaskResult	Object	해당 시	-	품질 검사 결과. `Output.AiQualityControlResultSet`에 검사 항목 포함
SmartSubtitlesTaskResult	Object	해당 시	-	스마트 자막 결과. 자막 파일 경로 포함
SmartEraseTaskResult	Object	해당 시	-	지우기 결과. 출력 영상 및 추출 자막 경로 포함
RequestId	String	항상	`3c140219-cfe9-470e-b241-907877d6fb03`	요청 식별자

호출 예시

LANGUAGE
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.mps.v20190612 import mps_client, models

cred = credential.Credential("<SecretId>", "<SecretKey>")
http_profile = HttpProfile()
http_profile.endpoint = "mps.tencentcloudapi.com"
client = mps_client.MpsClient(cred, "ap-guangzhou", ClientProfile(httpProfile=http_profile))

# 영상/오디오 태스크 조회
req = models.DescribeTaskDetailRequest()
req.from_json_string(json.dumps({"TaskId": "1250017490-20260318152230-abcdef123456"}))
resp = client.DescribeTaskDetail(req)
print(resp.to_json_string())

LANGUAGE
# 이미지 태스크 조회
req = models.DescribeImageTaskDetailRequest()
req.from_json_string(json.dumps({"TaskId": "1250017490-ImageTask-80108cc3380155d98b2e3573a48a"}))
resp = client.DescribeImageTaskDetail(req)
print(resp.to_json_string())

응답 예시

LANGUAGE
{
  "TaskType": "WorkflowTask",
  "Status": "FINISH",
  "CreateTime": "2026-03-18T15:22:30+08:00",
  "BeginProcessTime": "2026-03-18T15:22:35+08:00",
  "FinishTime": "2026-03-18T15:30:02+08:00",
  "MediaProcessResultSet": [
    {
      "Type": "Transcode",
      "TranscodeTask": {
        "Status": "SUCCESS",
        "Output": {
          "OutputStorage": {
            "Type": "COS",
            "CosOutputStorage": {
              "Bucket": "mybucket-125xxx",
              "Region": "ap-guangzhou"
            }
          },
          "Path": "/output/transcode/video.mp4"
        }
      }
    }
  ],
  "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}

사용 안내

AIGC 이미지·영상 및 문서-영상 생성 태스크는 전용 조회 API(DescribeAigcTaskStatus)를 사용합니다. Doc to Video를 참조하세요.

태스크를 제출한 API에 맞춰 조회 API를 선택합니다. 영상 처리와 이미지 처리 모두 TaskId에 WorkflowTask가 포함될 수 있습니다.

가로/세로 변환 결과는 AiAnalysisResultSet 아래 HorizontalToVerticalTask → Output에, 품질 검사 결과는 AiQualityControlTaskResult 아래 Output.AiQualityControlResultSet에 위치합니다.