· reAPI Team
Kie AI 작업 상태: 99%에서 멈췄나요, 아직 처리 중인가요?
생성이 99%에 머무를 때 Kie AI 작업 상태를 읽는 방법입니다. 다시 제출할지 결정하기 전에 원래 작업, 결과, 콜백과 크레딧 기록을 확인하세요.

진행률 표시줄은 99%에 도달했습니다. 그런데 영상은 아직 없습니다. 생성을 다시 클릭하기 전에 첫 번째 시도의 작업 ID를 찾으세요. 그래야 영상을 기다리는 것인지, 이미 존재하는 영상을 앱이 인식하기를 기다리는 것인지 구분할 수 있습니다.
Kie AI 작업 상태는 작업 기록에서 나옵니다. Market 작업의 경우 이 기록은 대기, 생성, 성공과 실패를 구분하며 상태와 함께 결과나 오류를 담습니다.[1] 백분율만으로는 다음 결정을 내릴 수 없습니다. 기존 작업부터 확인한 뒤, 실제 응답이 뒷받침하는 분기를 따르세요.
진행률 표시줄에 해당하는 작업 찾기
원래 제출에 대한 응답을 여세요. Kie의 Market API를 사용했다면 반환된 taskId를 찾으세요. 조회는 GET /api/v1/jobs/recordInfo?taskId=...이며, POST /api/v1/jobs/createTask로 생성한 작업을 가져옵니다. 다른 엔드포인트 계열은 각각의 문서가 필요합니다. 예를 들어 동기식 채팅 요청은 폴링할 Market 작업을 만들지 않습니다.[2][1]
웹사이트를 사용한다면 문서에서 제출한 작업, 매개변수와 결과를 찾는 곳으로 안내하는 Kie의 Logs 영역을 확인하세요.[3] 자동화에서는 제출 노드의 출력을 살펴보세요. 나중의 재시도가 아니라 그곳에서 ID를 복사하세요. 같은 프롬프트를 두 번 제출해도 각각 추적해야 할 두 번의 시도입니다.
직접 만든 앱에서는 고객의 작업 참조 옆에 제공업체 ID를 저장하세요. 영상이 아직 완료되지 않은 friday-demo라는 예약 게시물을 상상해 보세요. 일정 이름은 영상의 용도를 알려주고, 제공업체 ID는 어떤 생성을 가져와야 하는지 알려줍니다. 이는 권장하는 기록 구조이지 Kie 기능이 아닙니다. 둘 다 보관하면 창작 작업을 다시 시작하지 않고 워커를 재시작할 수 있습니다.
작업 ID가 전혀 없나요? 프롬프트를 바꾸기 전에 제출 로그로 돌아가세요. 응답이 유실되면 첫 제출의 결과는 미확정으로 남습니다. 두 번째 제출을 문제없는 재시도로 취급하기 전에, 사용 가능한 계정 내역이나 지원을 통해 첫 제출이 수락되었는지 확인해야 합니다.
워크플로를 바꾸기 전에 응답 읽기
작업 상태를 보기 전에 두 가지를 확인해야 합니다. 먼저 HTTP 응답을 보고, 다음으로 JSON code를 확인하세요. Kie 작업 참조 문서에는 잘못된 인증 정보와 누락되거나 존재하지 않거나 소유자가 다른 작업 ID를 비롯해 HTTP 200 응답 내부의 업무 오류가 설명되어 있습니다. HTTP 오류 응답도 나열되어 있습니다. 둘 중 하나만 처리하면 빈틈이 생깁니다.[1]
워크플로가 멈춘 것처럼 보일 때 중요한 부분입니다. 폴러는 계속 조회 오류를 받는데 화면은 마지막 진행률을 표시한다면, 백분율을 1분 더 바라봐도 작업이 무엇을 하는지 알 수 없습니다. ID와 계정을 원래 제출과 비교하세요. API 키를 제외한 오류 본문을 저장하세요. 생성을 진단하기 전에 조회부터 고치세요.
조회가 성공하면 data.state를 읽으세요.
waiting과queuing은 작업이 대기열에서 기다리고 있다는 뜻입니다.generating은 처리가 진행 중이라는 뜻입니다.success는 반환된 결과를 확인할 수 있다는 뜻입니다.fail은failCode와failMsg를 확인해야 한다는 뜻입니다.
이것이 Market API에 문서화된 상태입니다.[1] 알 수 없는 값은 클라이언트에서 별도로 처리해야 합니다. 이를 아무 설명 없이 실패로 취급하면, 이해하지 못한 응답을 다시 생성하는 이유로 바꾸게 됩니다.
다음 디코더는 이 경우들을 구분합니다. 사용자의 서버가 이미 가져온 응답을 처리하며, 제출이나 자동 재시도는 포함하지 않습니다.
function inspectMarketTask(httpStatus, body) {
if (httpStatus < 200 || httpStatus >= 300) {
return { kind: 'lookup_error', httpStatus };
}
if (body?.code !== 200 || !body.data) {
return { kind: 'lookup_error', code: body?.code, message: body?.msg };
}
const task = body.data;
if (['waiting', 'queuing', 'generating'].includes(task.state)) {
return { kind: 'pending', taskId: task.taskId, state: task.state };
}
if (task.state === 'fail') {
return {
kind: 'failed', taskId: task.taskId,
code: task.failCode, message: task.failMsg,
credits: task.creditsConsumed,
};
}
if (task.state !== 'success') {
return { kind: 'unknown_state', taskId: task.taskId, state: task.state };
}
let result;
try { result = JSON.parse(task.resultJson); }
catch { return { kind: 'result_unreadable', taskId: task.taskId }; }
const urls = result?.resultUrls;
if (!Array.isArray(urls) || !urls.length ||
urls.some(url => typeof url !== 'string' || !url.trim())) {
return { kind: 'output_missing', taskId: task.taskId };
}
return { kind: 'ready', taskId: task.taskId, urls };
}kind 레이블은 이 예제에 속합니다. 출력 확인은 파싱한 resultJson에 resultUrls가 들어 있는 미디어 작업을 대상으로 하며, 모든 모델의 출력을 다루지는 않습니다. 텍스트 모델과 피사체 감지 모델은 구조가 다릅니다.[1] ready조차 예상한 URL 문자열이 존재한다는 뜻일 뿐입니다. 실제 파일을 다운로드하고 확인하는 일은 아직 남아 있습니다.
성공했다면 파일 경로 따라가기
성공한 미디어 작업에서는 resultJson을 JSON으로 파싱하고 예상한 URL을 찾으세요. 이 필드는 JSON 문자열이므로 이미 객체인 것처럼 task.resultJson.resultUrls를 읽어서는 문서에 설명된 배열을 가져올 수 없습니다.[1]
그런 다음 응답에서부터 다음 단계로 확인해 나가세요. 예상한 미디어 필드가 있나요? 사용자의 서버가 그 URL에서 다운로드할 수 있나요? 저장 단계가 바이트를 저장했나요? 페이지는 저장된 파일을 가리키나요? 각 답이 재개할 위치를 좁혀 줍니다. 자체 스토리지 업로드 실패는 원본 파일이 여전히 사용 가능할 때 업로드를 반복할 이유이지, 생성을 한 번 더 구매할 이유가 아닙니다.
예를 들어 로그에 성공한 작업 뒤로 아카이브 업로드 실패가 나타난다고 가정해 보세요. 이는 가상의 디버깅 사례입니다. 성공한 작업 ID를 작업에 연결해 두고, 필요하면 결과를 가져온 뒤 아카이브 단계부터 재시작하세요. 대신 첫 노드부터 워크플로를 실행하면 저장 실패를 해결하지 않은 채 같은 창작 요청을 다시 생성에 보내게 됩니다.
유용한 출력은 즉시 저장하세요. Kie 홈페이지는 미디어 보관 기간을 14일로 안내하지만, Market 참조 문서에서 OmniHuman 1.5 Subject Detection의 URL 유효 기간은 1시간으로 설명합니다. 이 모델별 예외는 중요합니다.[3][1] 성공한 작업 기록과 영구히 다운로드할 수 있는 파일은 다릅니다. 다운로드한 파일, 원래 ID와 응답을 함께 보관하여 나중에 URL이 사라져도 발생한 일의 기록까지 잃지 않도록 하세요.
아직 생성 중이라면 같은 작업이 끝나도록 두기
Kie 가이드는 프로덕션에서 콜백을 사용하고 폴링에는 2~3초 간격으로 시작하는 지수 백오프를 권장합니다. 일부 영상 작업은 10분보다 오래 걸린다고도 설명합니다.[1] 이는 “10분이면 실패”라는 일률적인 규칙을 배제하기에 충분합니다. 지연된 모든 작업이 결국 성공한다는 약속은 아닙니다.
작업이 실행을 멈추기 전에 애플리케이션이 대기를 멈출 수 있습니다. 예약 게시물에는 마감이 있고, 브라우저 세션에서는 사용자의 인내심을 고려해야 합니다. 자체 대기 제한이 만료되면 어떻게 할지 결정하세요. 유용한 로컬 결과로는 “확인 필요”가 있으며, 나중에 조회하도록 작업 ID를 보관합니다. 최종 상태 응답 없이 “실패”라고 부르면 관찰만 중단했는데도 다음 담당자는 생성이 종료되었다고 생각하게 됩니다.
callBackUrl을 설정했다면 콜백 경로도 확인하세요. Kie는 성공 및 실패 작업 알림을 지원합니다. 검증 방식은 응답 본문 전체가 아니라 작업 ID와 타임스탬프에 서명하며, 가이드는 권위 있는 결과를 위해 인증된 작업 조회를 다시 안내합니다.[4]
알림으로 기존 작업을 깨우세요. 상태를 가져온 뒤 폴링 후와 같은 완료 처리를 실행하세요. 폴링으로 이미 영상을 회수했다면 나중에 온 콜백은 완료된 로컬 작업을 찾아야 합니다. 완료가 다른 경로로 도착했다는 이유만으로 같은 게시물을 다시 발행할 수 없도록 처리기를 설계하세요.
n8n에서는 처리가 필요한 단계부터 재시작하기
살펴볼 설정은 HTTP Request 노드의 Retry on Fail입니다. n8n 문서는 실패한 노드를 재시도한다고 설명합니다.[5] 켜기 전에 그 노드 안의 작업을 읽어 보세요.
알려진 작업을 조회하는 노드는 조회를 반복할 수 있습니다. 생성 POST를 보내는 노드는 제출을 반복합니다. 둘 다 HTTP를 쓴다는 이유만으로 같은 재시도 결정을 적용해서는 안 됩니다. 더 큰 워크플로가 제출, 대기와 다운로드를 하나의 재시작 가능한 단계로 감싼다면 저장한 작업 ID를 분리하여 제출 이후부터 복구를 시작할 수 있도록 하세요.
위의 가상 아카이브 실패에서는 다운로드 또는 저장 노드가 재개 지점입니다. 콜백 유실이면 조회입니다. state: fail이면 먼저 실패 내용을 읽고 요청 변경이 타당한지 판단하세요. 제출 결과를 알 수 없다면 첫 시도를 대조하는 동안 자동 재실행을 중단하세요.
일일 영상 워크플로 가이드는 reAPI에서 지속적으로 보존되는 작업을 사용하는 방식을 보여줍니다. API 필드는 Kie와 다르지만 유용한 설계 선택은 같습니다. 완료한 일을 반복하지 않고 미완료 작업을 이어갈 만큼의 상태를 보존하는 것입니다.
실패했다면 오류를 청구 내역 옆에 보관하기
Kie는 실패한 작업에 요금을 부과하지 않는다고 말합니다. 작업 응답에는 상태, 오류 필드와 타임스탬프와 함께 creditsConsumed도 제공됩니다.[3][1] 해당 시도에 대해 이 기록들을 비교하세요. 다른 작업 여러 개가 실행 중이었다면 전체 잔액 변화만으로 영상 하나에 무슨 일이 있었는지 식별할 수 없습니다.
이미 생성을 다시 클릭했다면 조사할 때 두 ID를 모두 보관하세요. 첫 번째 작업이 진행률 표시줄에 해당하고 두 번째 작업이 확인 중인 청구에 해당할 수 있습니다. 청구 수정을 요청하기 전에 각 응답을 해당 제출과 연결하세요.
지원 요청에서는 작업 ID와 모델을 먼저 적고, 제출 시간과 시간대, 최신 응답, 오류 메시지와 관련 크레딧 항목을 이어서 제공하세요. 최종 상태 없음, 성공 결과지만 사용 가능한 URL 없음, 다운로드 실패, 또는 겉보기의 청구 불일치처럼 어디서 멈췄는지 설명하세요. Kie 홈페이지는 기술 문의를 지원 그룹으로 안내합니다.[3] 공유하는 모든 자료에서 인증 정보와 관련 없는 비공개 입력을 제거하세요.
실패 작업 정책이 있다고 해서 이 글이 개별 계정에 대한 환불을 약속할 수는 없습니다. 그 정책은 지원팀에 해결을 요청할 구체적인 불일치를 제시합니다. 작업은 성공했지만 영상이 요청 조건에 맞지 않았다면 별도로 설명하세요. 품질 불만과 기록된 생성 실패는 서로 다른 지원 문제입니다.
API를 바꾸더라도 복구 로직 가져가기
반복되는 복구 작업 때문에 reAPI를 검토한다면 작업 응답부터 확인하세요. 일반 미디어 작업은 processing, completed와 failed를 사용하고, 결과는 output 아래에 있으며 usage.credits는 정산된 사용량을 보고합니다. 알려진 작업의 폴링은 크레딧을 소모하지 않습니다.[6] Kie 응답 디코더를 그대로 재사용하는 대신 이 필드들을 명시적으로 매핑하세요.
고려해야 할 제한도 있습니다. reAPI 콜백은 서명되지 않으므로 인증된 조회를 통해 알려진 대기 작업을 검증하세요. 전달 정보는 ?include=webhook으로 확인할 수 있습니다.[7] Idempotency-Key를 넣어 생성 POST를 반복해도 중복 제거되지 않으며, 일부 모델별 생성 후 안전성 검사 실패는 요금이 유지됩니다.[8][6] 이전할 때도 저장된 시도 및 정산 확인을 유지하세요.
필요한 모델은 모델 카탈로그에서 확인하고, 더 넓은 선택 문제는 Kie 비교를 참고하세요. 플랫폼 변경도 두 번째 POST도 이미 99%에 머문 영상을 해결하지 않습니다. 그 영상은 작업 ID로 돌아가 결과를 확인할 수 있는 마지막 단계부터 이어가세요.
참고 자료
- Kie AI. 작업 세부 정보 가져오기, Market API. 2026년 11월 15일 열람.
- Kie AI. Market 빠른 시작 및 통합 API 구조. 2026년 11월 15일 열람.
- Kie AI. 홈페이지 자주 묻는 질문: 작업, 지원, 보관 및 체험 크레딧. 2026년 11월 15일 열람.
- Kie AI. Webhook 보안 검증. 2026년 11월 15일 열람.
- n8n. HTTP Request 노드의 일반적인 문제: Retry on Fail. 2026년 11월 15일 열람. HTTP Request 문제 해결.
- reAPI. 작업. 2026년 11월 15일 검토. 작업 폴링 문서.
- reAPI. Webhook. 2026년 11월 15일 검토. 전달 및 검증 계약.
- reAPI. API 개요. 2026년 11월 15일 검토. 제출 및 멱등성 문서.