GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
모든 가이드

· reAPI Team

API 데이터 보존: 링크가 만료되기 전에 출력 저장하기

생성 파일, 입력 업로드 및 백업의 API 데이터 보존을 계획하세요. 링크가 만료되기 전에 출력을 저장하고 복사본을 검증하며 삭제로 무엇이 제거되는지 확인하세요.

API 데이터 보존: 링크가 만료되기 전에 출력 저장하기

동영상 생성이 성공적으로 완료되었습니다. 데이터베이스에는 작업 ID와 다운로드 URL이 있습니다. 이것은 결과가 어디에 있었는지 보여 주지만, 동영상 아카이브는 아닙니다.

Replicate 문서에 명시된 기본 설정 때문에 이 차이가 중요합니다. API 예측의 입력, 출력 값, 출력 파일 및 로그는 한 시간 후 삭제됩니다. 웹사이트에서 생성한 예측에는 다른 규칙이 적용되어 수동으로 삭제할 때까지 유지됩니다.[1] 웹 세션에서 아직 보이는 파일이 API 결과를 얼마나 오래 다운로드할 수 있는지 알려 주지는 않습니다.

나중에 필요한 출력이라면 완료 워크플로에서 실제 바이트를 사용자가 관리하는 스토리지에 복사하고 그 복사본을 검증해야 합니다. 삭제할 때는 공급자의 버전과 사용자가 만든 복사본을 모두 고려해야 합니다. 파일 하나를 이 단계에 따라 살펴보면 보존과 관련된 질문이 구체적으로 드러납니다.

다운로드에 별도의 완료 상태 부여하기

가상의 생성 동영상을 생각해 보세요. 생성은 완료되었고 아카이브 작업자가 출력을 복사하기 시작합니다. “생성 완료”와 “복사본 검증 완료”를 별도로 유지하세요. 다운로드에 실패하면 첫 번째 상태는 참일 수 있지만 두 번째 상태는 여전히 거짓일 수 있습니다.

완료된 작업의 문서화된 출력 필드를 읽고 보존할 각 파일을 식별하세요. 출력이 여러 개인 작업이라면 출력 인덱스나 이에 상응하는 식별 정보를 작업 ID와 함께 저장하세요. 성공 여부만 나타내는 단일 플래그로는 여러 파일 중 어느 것이 복사되었는지 알 수 없습니다.

애플리케이션에서 승인된 접근 경로를 통해 다운로드하고, 대상 객체를 기록한 다음, 영구 저장된 것으로 표시하기 전에 확인하세요. 대상 객체가 존재하고 전송이 완료되었으며 크기와 미디어 유형이 타당한지 확인하세요. 가능하다면 직접 소유한 복사본을 열거나 디코딩하세요. 체크섬은 다운로드한 바이트와의 일관성을 검증할 수 있지만 생성된 장면이 정확하거나 동영상이 고객의 요청에 부합한다는 점까지 증명하지는 못합니다.

원본 URL, 작업 ID, 출력 식별 정보, 대상 객체 키 및 복사 시간을 함께 보관하세요. 나중에 애플리케이션에서 접근할 때는 자체 객체 식별 정보를 사용하세요. 임시 공급자 URL을 데이터베이스의 다른 열에 저장해도 독립적인 복사본이 생기지는 않습니다.

같은 완료 알림이 다시 도착하면 작업 및 출력 식별 정보를 사용해 이미 검증된 복사본을 알아보세요. 미완료 전송은 적절히 재시도하되, 알림이 반복되었다는 이유만으로 설명되지 않는 중복본을 만들지 마세요. 이는 제안하는 애플리케이션 워크플로이지, 모든 공급자가 사용자를 대신해 아카이브를 구현한다는 주장은 아닙니다.

모델이 성공한 뒤에도 작업자가 실패할 수 있습니다

동영상 예시에서 생성이 완료될 때 아카이브 작업자를 사용할 수 없다고 가정해 보세요. 복사본은 대기 상태로 남아 있어야 합니다. 작업자가 복구되면 원본을 계속 사용할 수 있는 동안 가져오기를 시도할 수 있습니다. 원본이 만료되었다면 작업을 조용히 아카이브 완료로 표시하지 말고 보존 실패를 기록하세요.

동영상을 다시 생성한 뒤 원본 파일을 복구했다고 설명하지 마세요. 재생성은 별도의 작업이며 다른 콘텐츠가 생성될 수도 있고 추가 요금이 발생할 수도 있습니다. 먼저 기존에 검증된 복사본이나 공급자가 문서화한 다른 가져오기 경로가 있는지 확인하세요. 예를 들어 fal은 만료된 CDN 파일이 영구 삭제되어 복구할 수 없다고 설명합니다.[2]

따라서 복사 작업을 설계할 때 보존 기간을 고려해야 합니다. 애플리케이션이 해당 기간 안에 안정적으로 아카이브할 수 없다면 워크플로를 변경하거나 나중에 접근할 수 있다고 약속하기 전에 문서화된 스토리지를 마련하세요. 한 번의 관찰에서 링크가 우연히 더 오래 작동했다고 해서 저장이 보장되는 것은 아닙니다.

reAPI의 작업 문서도 장기 아카이브를 위해 생성된 출력을 신속하게 복사하도록 권고합니다. 재호스팅된 CDN 출력을 설명하며 수명 주기 정책은 배포별로 구성되고 해당 계약으로 보장되지는 않는다고 명시합니다.[3] 이는 자체 복사본을 저장해야 한다는 근거가 되지만, 반환된 모든 URL에 고정 만료일이 있거나 영구 호스팅된다는 뜻은 아닙니다.

복구 확인에는 승인된 합성 자산을 사용하고 원래 공급자 링크에 의존하지 않은 채 대상 복사본을 읽으세요. 확인 결과를 보관하세요. 업로드 성공 보고보다 애플리케이션이 직접 소유한 객체를 가져와 사용할 수 있다고 확인하는 것이 더 유용합니다.

요청 기록과 미디어 파일의 수명은 다를 수 있습니다

서비스 규칙에 따라 가상의 동영상 작업은 계속 표시되지만 파일은 더 이상 사용할 수 없을 수 있습니다. 반대로 요청 콘텐츠를 제거해도 모든 미디어 객체가 삭제되는 것은 아닙니다. 보존 기간을 정하기 전에 객체가 무엇인지 명확히 하세요.

fal 문서에 따르면 요청 기록의 입력 및 출력은 기본적으로 90일 동안 보존됩니다. CDN 파일에는 별도로 구성 가능한 보존 기간이 있습니다. X-Fal-Store-IO: 0은 요청 기록 페이로드 저장을 제어하고 X-Fal-Object-Lifecycle-Preference는 미디어 수명을 제어하며 요청별 설정이 계정 기본값보다 우선합니다.[2] 기록 설정만으로 모든 저장이 꺼지는 것은 아닙니다.

입력을 업로드하면 객체가 하나 더 추가됩니다. 공급자 복사본을 사용해 동영상을 생성하는 동안 원본 이미지는 사용자의 버킷에 남아 있을 수 있습니다. 나중에 삭제해야 한다면 이러한 복사본 사이의 관계를 유지하세요. 출력 동영상의 수명으로 참조 이미지의 수명을 알 수는 없습니다.

컬렉션과 공유 뷰는 또 다른 계층입니다. fal은 Assets를 활성화하거나 파일을 컬렉션에 넣거나 컬렉션을 공유해도 기반 파일의 수명이 연장되지 않는다고 설명합니다.[4] 저장된 라이브러리 관계가 가리키는 미디어를 사용할 수 있는 기간보다 오래 남을 수 있습니다.

같은 논리는 문서 워크플로에도 적용됩니다. 재사용 가능한 PDF 주석에는 파일 참조뿐 아니라 추출된 콘텐츠가 포함될 수 있습니다. 애플리케이션이 이를 저장한다면 원본 문서와 함께 해당 복사본도 보존 결정에 포함하세요.

라이브러리 항목 삭제는 파일 삭제와 다릅니다

동영상이 이제 사용자의 버킷에 아카이브되어 있고 공급자 측 버전을 제거하려 한다고 가정해 보세요. 목표에 맞는 작업을 선택하세요. 라이브러리에서 숨기기, 컬렉션 구성원에서 제거하기, CDN 파일 삭제하기는 서로 다른 작업입니다.

fal의 Assets 문서에 따르면 에셋을 삭제하면 라이브러리와 검색 결과에서 제거되지만, 그 자체로 기반 CDN 파일이 삭제되지는 않습니다. 컬렉션에서 제거하는 작업은 그보다 범위가 좁습니다. 에셋은 라이브러리와 다른 컬렉션에 남을 수 있습니다.[4] 제거 후 컬렉션만 확인하면 파일 삭제가 아니라 뷰의 변경만 확인하는 것입니다.

완료된 생성 작업의 경우 fal은 별도의 요청 페이로드 삭제 작업을 문서화하며, 이 작업은 CDN 출력 파일도 대상으로 합니다. CDN 입력 파일은 다른 요청에서 재사용될 수 있으므로 제거하지 않습니다.[2] 참조 이미지도 삭제해야 한다면 다른 곳에서 사용 중인지 확인한 후 적절한 파일 작업으로 처리하세요.

파일 수준에서 결과를 검사하세요. fal의 삭제 응답에는 cdn_delete_results가 있으며, 각 파일의 대상 링크와 exception 값이 포함됩니다. 항목의 값이 null이면 해당 항목의 삭제가 성공한 것입니다.[5] 전체 응답을 받았더라도 여러 출력 중 하나에 대해 보고된 예외를 무시해서는 안 됩니다.

작업 시간, 대상 및 해결되지 않은 실패를 기록하세요. 이후 다운로드가 실패하면 해당 가져오기 경로에 대한 증거는 되지만 모든 내부 백업이나 후속 복사본이 사라졌다는 증거는 아닙니다. 삭제에 관한 설명은 문서화된 작업 범위와 실제로 확인한 결과 내에서만 하세요.

Replicate 웹사이트의 Delete 작업에는 별도로 문서화된 범위가 있습니다. 예측 및 관련 출력 데이터와 파일을 제거합니다.[1] 생성 경로에 해당하는 규칙을 사용하고 모든 대시보드의 삭제 버튼이 fal의 라이브러리 작업과 동일하다고 가정하지 마세요.

내보내기와 백업까지 복사본 추적하기

공급자 버전을 제거해도 이제 사용자의 버킷에 있는 동영상은 제거되지 않습니다. 고객이 내보내기 파일을 다운로드했다면 그것은 또 다른 복사본입니다. 공유 링크를 취소하면 해당 링크를 통한 접근은 중단되지만 수신자가 이미 다운로드한 파일을 회수하지는 못합니다. fal의 공유 안내는 이 결과를 명시적으로 구분합니다.[4]

직접 관리하는 복사본에는 작업 및 출력 식별 정보, 소유자, 저장 위치와 삭제 규칙을 객체와 함께 보관하세요. 그러면 나중에 삭제 요청이 왔을 때 임시 URL이나 레이블이 없는 내보내기 파일명에 의존하지 않고 처리할 수 있습니다. 워크플로에서 생성하는 미리보기, 저장된 버전과 마이그레이션 복사본도 포함하세요.

백업에 대해서도 명확한 결정을 내려야 합니다. 의도한 복구 목적에 맞게 보관하고, 복원된 데이터가 이후 삭제와 어떻게 조정되는지 고려하세요. 그렇지 않으면 오래된 백업을 복원할 때 애플리케이션이 이미 제거한 콘텐츠가 다시 들어올 수 있습니다. 스토리지를 마이그레이션할 때는 참조를 전환하기 전에 대상 위치를 검증하고 소유권과 보존 결정을 바이트 데이터와 함께 옮기세요.

원본, 미리보기와 백업도 대상 스토리지를 차지합니다. 스토리지 비용을 추정할 때 복사본 수와 각 복사본의 보존 기간을 포함하세요. 공급자 버전을 삭제해도 자체 아카이브 비용은 없어지지 않습니다.

여기서 다루는 생성 출력 계약에는 보편적인 7년 보존 요건이 없습니다. 기록 유형마다 요건이 다를 수 있으므로 송장에 적용되는 기간을 모든 생성 동영상의 수명으로 자동 적용해서는 안 됩니다. 익숙한 숫자를 고르는 대신 객체와 목적에 적용되는 정책을 정의하세요.

데이터는 어디에 저장될까요? 이 예에서는 공급자의 요청 기록, CDN 미디어, 사용자가 소유한 객체, 내보내기와 백업에 있을 수 있습니다. 지리적 데이터 레지던시는 별도의 계약 문제입니다. 미디어 URL만으로 모든 복사본이 어디에서 처리되거나 저장되는지 알 수는 없습니다.

스토리지, 공유 및 학습 문제를 분리해서 보기

데이터를 학습에 사용하지 않는다는 설명만으로 데이터가 전혀 저장되지 않는다고 볼 수는 없습니다. OpenAI의 API 데이터 가이드는 남용 모니터링 로그와 애플리케이션 상태를 구분합니다. Zero Data Retention 제어는 자격을 갖추고 승인을 받은 고객이 사용할 수 있으며 엔드포인트 및 기능 제한이 적용됩니다.[6] 실제 조직, 프로젝트와 작업에 적용되는 범위를 확인하세요.

fal도 요청 기록 및 CDN 설정은 배포 소유자의 애플리케이션 로깅이나 애플리케이션이 관리하는 영구 스토리지를 설정하지 않는다고 설명합니다. ZDR이 필요한 사용자에게는 엔드포인트 적용 범위를 확인하도록 요청합니다.[2] 애플리케이션, 도구와 자체 스토리지를 함께 사용하는 워크플로의 모든 복사본을 하나의 헤더로 설명할 수는 없습니다.

가상의 동영상에 대한 최종 기록은 이제 두 가지 실무 질문에 답해야 합니다. 향후 다운로드에 사용할 검증된 복사본은 무엇인가? 다른 복사본 중 어떤 것이 삭제되었고 어떤 것이 명시된 규칙에 따라 남아 있는가? 전송 실패나 파일별 삭제 예외는 해결될 때까지 표시된 상태로 유지하세요. 그러면 애플리케이션은 생성 완료, 사용 가능한 아카이브와 삭제 완료를 같은 사건인 것처럼 가장하지 않고 구분할 수 있습니다.

참고 자료

  1. Replicate, “데이터 보존,” 공식 predictions 문서. 2026년 11월 16일 열람. API 기본값과 웹사이트 삭제는 적용 범위가 다릅니다.
  2. fal, “데이터 보존 및 스토리지,” 공식 Model APIs 문서. 2026년 11월 16일 열람. 요청 기록, CDN 및 배포 소유자의 책임은 서로 구분됩니다.
  3. reAPI, 작업 문서, 출력 형식 및 아카이브 안내. 2026년 11월 16일 검토.
  4. fal, “보존 및 삭제,” 공식 Assets 문서. 2026년 11월 16일 열람. 라이브러리 작업, 파일 수명 및 다운로드된 복사본.
  5. fal, “요청 페이로드 삭제,” 공식 Platform API 참조. 2026년 11월 16일 열람. 파일별 삭제 결과. 이 가이드에서는 삭제를 수행하지 않았습니다.
  6. OpenAI, 사용자 데이터. 2026년 11월 16일 열람. 학습 정책, 보존 제어 및 엔드포인트 제한.
모든 가이드