AI 생성 영상 URL은 만료되나요? Sume의 결과물 보관 방식
Format 실행과 Agent Completions에서는 만료되지 않습니다. Sume는 그 미디어를 만료되지 않는 media.sume.com URL로 돌려주며, 링크를 가진 누구나 열 수 있습니다.
Sume Format 실행과 Agent Completions에서는 만료되지 않습니다. 둘 다 생성한 미디어를 만료되지 않는 내구성 있는 media.sume.com HTTPS URL로 돌려주므로, URL을 저장해 두었다가 나중에 렌더링할 수 있습니다. 대신 그 URL은 공개되어 있어, URL을 가진 누구나 파일을 가져올 수 있습니다.
이 답은 2026-09-27에 확인한 Sume의 실행과 결과 (영문), 구조화 출력 (영문), Format 임베드하기 (영문) 문서를 바탕으로 합니다. 문서가 다르게 설명하는 표면 세 가지는 아래에서 다룹니다. 생성 Job 결과, Image API, /v1/videos 다운로드 경로입니다.
Sume의 어떤 출력 URL이 만료되지 않나요?
Sume는 생성 결과물을 노출하기 전에 Sume 소유의 미디어 URL로 미러링합니다. Format 실행 출력을 다루는 구조화 출력 문서는 여기에 더해, Sume가 호스팅하는 미디어는 media.sume.com에서 public, max-age=31536000, immutable로 제공되며 만료되지 않는다고 설명합니다. 그래서 저장해 둔 실행 URL은 렌더링하기 전에 갱신할 필요가 없습니다. Job 문서들은 Job 아티팩트를 공개라고 부르지만, 만료 규칙은 밝히지 않습니다.
| URL | 받는 곳 | 만료 여부 | 접근 |
|---|---|---|---|
primary_output_url, artifacts[].url, output 안의 미디어 | Format 실행 영수증 또는 웹훅 | 만료 안 됨. 내구성 있는 media.sume.com URL | URL을 가진 누구에게나 공개 |
output과 artifacts 안의 미디어 | Agent Completion 영수증 | 만료 안 됨. 내구성 있는 media.sume.com URL | URL을 가진 누구에게나 공개 |
result.artifacts[].url | GET /v1/jobs/{id}/result | Job 문서에 명시 없음 | media.sume.com 아래의 공개 아티팩트 |
data[].url | POST /v1/images 응답 | 내구성 있다고 명시되지 않음. 아래 참고 | Sume 호스팅, 서명됨 |
unsigned_urls[] | GET /v1/videos/{id} 폴링 | GET /v1/videos/{id}/content를 가리킴 | API 키 필요. 영상으로 리다이렉트 |
media.sume.com URL은 누가 열 수 있나요?
링크를 가진 누구나 열 수 있습니다. 쿡북은 내구성 있는 URL이 로그, 오류 리포트, 고객의 브라우저 기록에 남게 된다고 경고합니다. 그러니 고객 A가 고객 B의 결과물을 절대 보면 안 된다면, 자체 인증 라우트로 바이트를 프록시하거나 직접 보관한 사본을 제공하세요.
지원 티켓에도 링크를 넣지 마세요. Format 오류 문서는 API 키, 서명 시크릿, 원본 미디어 URL을 보내지 말라고 안내합니다. 공개 URL이라고 해서 다른 워크스페이스의 입력으로 쓸 수 있는 것은 아닙니다. 영상 트림은 자기 워크스페이스의 media.sume.com 아티팩트나 에셋만 받으며, 다른 워크스페이스의 URL에는 source_not_found로 응답합니다.
URL을 저장해야 하나요, 파일을 복사해야 하나요?
둘 다 괜찮지만, 하나로 정하세요. 링크는 무료이고 즉시 쓸 수 있습니다. 복사는 스토리지 비용이 들지만 나중에 Sume를 떠나더라도 남습니다. 그 보장을 원한다면 레코드를 준비 완료로 표시하기 전에, 웹훅을 받는 시점에 복사하세요. 멀티테넌트 앱에서 이 단계가 어디에 들어가는지는 제품에 AI 영상 생성을 임베드하는 방법에서 보여 줍니다.
- 원본 프로바이더 URL이 아니라 Sume URL을 저장하세요. 원본 프로바이더 URL은 공개 결과 계약에 포함되지 않습니다.
artifacts[]는 실행이 종료될 때까지 비어 있다가, 종료되면 실행이 생성한 내구성 있는 파일을 모두 나열합니다. 실패한 경우에도 마찬가지이므로, 실패한 실행을 포기하기 전에 확인하세요.
어떤 URL이 서명되어 있거나 API 키가 필요한가요?
미리 대비해야 할 예외는 Image API입니다. POST /v1/images는 data[].url을 Sume가 호스팅하는 서명된 URL로 돌려주며, 문서는 이를 내구성 있는 URL이라고 부르지 않습니다. 인증 문서는 서명된 업로드·다운로드 URL을 임시 시크릿으로 취급하라고 하므로, 보관해야 할 이미지는 복사해 두세요.
/v1/videos에서는 폴링 응답의 unsigned_urls[]가 api.sume.com의 GET /v1/videos/{id}/content를 가리킵니다. 이 경로는 API 키가 필요하고 생성된 영상으로 리다이렉트하며, Job이 아직 실행 중이면 409 job_not_completed로 응답합니다. 이 경로는 API로 생성된 영상 다운로드하기에서 다루고, 스키마는 Sume API 레퍼런스에 있습니다.
구조화 출력에서는 모든 미디어 파일에 expires_at이 있습니다. 일반적인 경우인 내구성 있는 media.sume.com URL에서는 null이고, 서명된 URL이 반환될 때만 값이 채워지므로 코드에서 이 값으로 분기할 수 있습니다.
출처
관련 글
개발자 카테고리의 다른 글
- AI 영상 생성 API 고르는 법: 12가지 체크리스트
AI 영상 생성 API는 Job, 재시도, 웹훅, 지출 상한, 실패, 출력물을 어떻게 다루는지를 보고 고르세요. 항목마다 Sume의 답을 붙인 체크리스트입니다.
- 브라우저에서 Sume API 호출 시 CORS 오류: 해결 방법
브라우저는 내 사이트에서 api.sume.com으로 직접 보내는 호출을 차단하며, API 키는 프론트엔드 코드에 절대 넣으면 안 됩니다. 서버에서 Sume를 호출해 프록시하세요.
- Sume API 엔드포인트 목록: 경로, 스코프, 멱등성
Sume API의 공개 경로를 계열별로 정리한 색인입니다. 키가 필요 없는 경로, 계열별 스코프, Idempotency-Key 적용 위치, 계열별 설명 글을 담았습니다.
- Sume API 오류 코드 총정리: 표면별 색인과 다음 조치
Sume API 오류 코드를 표면별로 정리했습니다. 공통 코드, 유료 생성, Format, Scheduled 실행, Agent Completions, 미디어 도구, 호스팅 MCP를 다룹니다.
작성자 Sume