메인 콘텐츠로 건너뛰기
idempotencyKey는 제출에 선택적으로 넣는 문자열입니다. 같은 키로 다시 보내면 첫 제출이 만든 태스크를 받으며, 새 작업이 큐에 들어가거나 새 크레딧 보류가 걸리지 않습니다.
키가 없으면 중복 제거도 없습니다. 제출할 때마다 새 태스크가 생깁니다. cron이나 재시도하는 워커가 두 번 보낼 수 있는 작업에는 키를 지정하세요.
키는 시도가 아니라 작업 단위로 만드세요. "{jobId}:{promptId}:{engine}" 같은 키는 그 작업을 몇 번 재시도해도 같게 나옵니다.

엔드포인트별 반복 키 처리

단건 엔드포인트는 명시적 생성 의미를 유지합니다. 이미 있는 태스크를 만들라고 요청했으므로 충돌을 받습니다. 오류의 error.details.taskId에 기존 태스크 id가 있으므로, 제출 응답을 받지 못했어도 그 id로 결과를 조회할 수 있습니다.
500개짜리 배치는 중복을 성공으로 흡수합니다. 그래서 워커가 재시작 후 작업 전체를 다시 보내도 이미 들어간 항목 때문에 배치가 실패하지 않습니다.

위치 그리드

그리드의 idempotencyKey는 그리드 id가 됩니다(생략하면 UUID가 생성됩니다). 각 지점의 태스크 키는 <grid id>:r<row>c<col>입니다. 같은 id로 같은 그리드를 다시 보내면 기존 지점을 반환하고 없는 지점만 받습니다. 같은 id로 중심, 크기, 반경이 다른 그리드를 보내면 좌표가 다른 지점은 RESOURCE_ALREADY_EXISTS로 실패합니다. 새 그리드에는 새 키를 쓰세요.

범위와 길이

키는 계정 단위로 적용됩니다. 다른 계정이 같은 문자열을 써도 충돌하지 않습니다. UUID 형식일 필요는 없습니다.

결과를 제출과 짝짓기

키를 보내지 않았다면 idempotencyKey는 null로 반환되지 않고 태스크 객체에서 생략됩니다.

키 수명

키는 요청 후 최소 30일 동안 예약된 상태로 남습니다. 태스크가 완료되거나 실패한 뒤에도, 24시간 폴링 기간이 끝난 뒤에도 마찬가지입니다. 폴링이 404를 반환해도 키는 풀리지 않습니다. 한 제출의 전송 재시도에는 같은 키를, 같은 작업의 별도 실행에는 새 키(예: :r1 접미사 추가)를 쓰세요.

다음 단계

배치와 그리드

세 가지 대량 제출 엔드포인트 비교.

오류

모든 요청 오류 코드.