API 참조

파일 보관 재시도

POST/v1/files/{file_id}/retry

동일 계정/키의 과거 파일입니다. 할당량이 소진된 유효한 키는 허용하지만 폐기/만료된 키는 거부합니다. 다운로드에는 ready가 필요하며 참조 중 삭제는 409를 반환합니다. retry는 원래 결과 저장만 재시도하고 생성하지 않습니다. 일반 API는 일 단위 보관을, 영구 보관 작업은 참조 보호를 사용하며 expires_at=0은 고정 만료 시각이 없음을 뜻합니다.

저장 실패 후 복구

먼저 사용 가능한 공간과 오류 원인을 확인하세요. 이 작업은 저장 공간을 다시 요청하고 원래 결과를 보관합니다. 생성 서비스를 다시 호출하지 않으며 원래 작업의 요금을 변경하지도 않습니다. 원래 소스가 만료되었다면 재시도도 실패할 수 있습니다.

영구 보관 작업 참조로 보호되는 파일은 작업 수명 주기를 통해 관리하세요. 공간을 확보하려고 참조 중인 파일을 삭제하지 마세요. 요금과 저장 상태를 별도로 확인하세요. 요금을 참고하세요.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

file_idstring필수
동일 키 소유의 관리형 파일 공개 ID입니다.

응답과 오류

HTTP 200

파일 보관 재시도 성공

application/json

유형: object
필수 필드: idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at

idstring필수
해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
source_kindstring필수
파일 소스 분류이며 수명 주기와 참조 보호 규칙을 결정합니다.
source_indexinteger필수
원본 결과 항목 인덱스입니다.
modelstring필수
현재 키의 카탈로그에 있는 공개 모델 ID입니다.
statusstring필수
waiting/pending/archiving/ready/failed/deleting 등의 백그라운드 저장 단계입니다. 다운로드 URL은 ready 이후에만 사용할 수 있습니다.
mime_typestring필수
검증된 파일 MIME 유형입니다.
file_namestring필수
공개 다운로드 파일명입니다.
sha256string선택 사항
확정된 경우 반환하는 보관 콘텐츠의 SHA-256입니다.
size_bytesinteger필수
바이트 단위 파일 크기입니다.
error_codestring선택 사항
분기 로직에 사용할 수 있는 공개 오류 코드입니다.
created_atinteger필수
Unix 초 단위 생성 시각입니다.
updated_atinteger필수
Unix 초 단위 마지막 갱신 시각입니다.
expires_atinteger필수
Unix 초이며 0은 장기 보관을 뜻합니다. 일반 API는 배포 환경의 일 단위 보관 정책을 따릅니다. 영구 보관 이미지/동영상은 참조로 결과를 보호하며 삭제 후에도 요금과 멱등성 기록은 남습니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항