문제 해결과 요청 복구

접수 여부가 불확실한 요청, 견적 충돌, 업로드 실패와 스트림 중단을 진단합니다.

진단 정보 남기기

발생 시각, API, HTTP 상태, 업무 code, request_id, 받은 taskId를 기록하세요. 명시적 거절, 네트워크 응답 없음, 접수 후 실패를 구분합니다. 일반 로그나 문의에 API 키, 프롬프트 전문, 원본 파일을 첨부하지 마세요.

모델이 없거나 사용할 수 없음

인증된 카탈로그를 새로 조회해 enabled, available과 정확한 작업 모델 ID를 확인하세요. 공개 모델 페이지가 있다고 계정에서 호출할 수 있는 것은 아닙니다. 50301이 계속되면 가용성을 확인하고 재시도 횟수를 제한하세요. 미공개 모델은 반복 호출로 활성화되지 않습니다.

입력 오류와 견적 충돌

400은 현재 inputSchema의 타입, 열거값, 조건부 필수 항목을 확인하고 미지원 필드를 제거합니다. 40901은 입력, 유효기간 또는 가격이 바뀐 경우이므로 새 견적을 확인받습니다. 일반 409는 작업별로 판단하세요. 다른 입력에 연결된 키 충돌은 업무 연결을 수정해야 합니다.

작업 ID를 받기 전에 시간 초과

기존 입력과 Idempotency-Key를 유지하고 유효기간 안에서 같은 제출을 복구한 뒤 새 요청을 결정하세요. taskId를 받으면 recordInfo를 조회합니다. 시간 초과, 탭 닫기, 연결 해제는 접수된 작업을 취소하지 않습니다. state, cost, settled로 결과를 확인하세요.

업로드했지만 파일 입력이 거절됨

PUT 이후 files/{fileId}/commit이 필요합니다. 반환된 spicy:// URI를 모델이 지원하는 입력 필드에 넣고 uploadUrl은 넣지 마세요. 서명된 Content-Type, 크기, 형식, 소유 계정과 만료를 확인합니다. 업로드는 하루 보관되므로 재시도 전에 다시 업로드하고 입력을 바꿔야 할 수 있습니다.

콜백이 없거나 다운로드 만료

HTTPS 수신 주소, 원본 바이트 서명 검증, 빠른 성공 응답을 확인하세요. recordInfo로 상태를 복구하고 중복 알림으로 주문을 두 번 처리하지 않도록 합니다. 결과 보관기간 안에서는 만료된 다운로드 URL을 재발급받으세요. pending은 나중에 재시도하고 unavailable이나 결과 만료는 옛 링크를 새로고침해도 복구되지 않습니다.

스트림이 일찍 종료됨

HTTP 상태와 Content-Type을 먼저 확인하고 해당 프로토콜의 SSE를 파싱하세요. TCP 조각은 이벤트가 아니며 연결 종료도 성공 표시가 아닙니다. 종료 이벤트, 오류와 앱 제한 시간을 확인합니다. 연결이 끊겨도 환불이나 무료 재전송을 가정하지 말고 request_id와 사용 기록을 확인하세요.

잔액, 한도와 지원

40201은 가용 잔액, 40202는 계정과 키 지출 한도, 429는 Retry-After와 전송 빈도를 확인하세요. 지원 요청에 키를 보내지 마세요. 재현 절차, 시각, 요청 ID, 민감값을 뺀 입력 구조와 기대·실제 결과를 제공하세요.