작업 조회와 재시도
On this page
TaskId가 반환되면 생성이 완료된 것입니까?
TaskId 반환은 비동기 작업이 접수되었다는 의미입니다. 해당 조회 API에서 완료 상태와 결과 필드를 확인한 뒤 파일을 사용하십시오. 접수 응답만으로 생성 성공을 판정하지 마십시오.
작업 상태는 어떤 API로 조회합니까?
작업을 생성한 API에 대응하는 조회 API를 사용합니다. VOD AIGC는 DescribeTaskDetail을 사용합니다. MPS AIGC의 이미지·영상·오디오 작업은 각각 DescribeAigcImageTask, DescribeAigcVideoTask, DescribeAigcAudioTask를 사용합니다. MPS ProcessMedia 작업은 DescribeTaskDetail을 사용하며, 별도 이미지 처리 작업은 DescribeImageTaskDetail을 사용합니다. 이름이 유사하더라도 다른 작업의 TaskId를 혼용하지 마십시오.
요청이 시간 초과되면 바로 다시 생성해도 됩니까?
응답을 받지 못했더라도 서버에서 작업을 접수했을 수 있습니다. TaskId를 확보했다면 먼저 상태를 조회하십시오. 식별자가 없다면 요청 시각과 요청 식별자를 보관하고 접수 여부를 확인하십시오. 생성 요청을 무조건 반복하면 중복 작업과 비용이 발생할 수 있습니다.
조회 간격과 재시도는 어떻게 구성합니까?
API의 호출 제한을 준수하고 재시도 간격을 점진적으로 늘리십시오. 여러 작업이 동시에 같은 시점에 조회되지 않도록 간격에 무작위 지연을 추가할 수 있습니다. 완료·실패와 같은 최종 상태를 받으면 조회를 중단하고, 애플리케이션의 최대 대기 시간도 별도로 설정하십시오.
실패한 작업과 조회 요청 실패는 어떻게 구분합니까?
작업 조회 HTTP 요청의 실패와 생성 작업의 최종 실패는 구분해야 합니다. 일시적인 네트워크 오류는 조회를 재시도할 수 있지만, 작업이 최종 실패 상태라면 반환된 오류 코드와 입력 조건을 확인해야 합니다. 인증이나 파라미터 오류를 수정하지 않은 채 반복 요청하지 마십시오.