TokenLab

핵심 가이드

데이터 보존

요청 세부 정보 및 미디어에 액세스할 수 있는 기간과 중요한 결과를 보관하는 방법

요청 및 응답 세부 정보와 자동으로 저장된 미디어 결과는 30일 동안 사용할 수 있습니다. 대화 기록, 청구 기록, 저장된 Media Assets 및 다운로드한 파일은 별도로 처리됩니다.

전체 설명은 TokenLab 데이터 보존을 참조하세요.

요청 및 응답 세부 정보

저장된 요청 및 응답 콘텐츠는 기록된 시점부터 30일 동안 Console, Request Debugger 및 TokenLab Agent (Assistant)에서 사용할 수 있습니다. 만료 후에는 이러한 도구에서 해당 원본 콘텐츠를 더 이상 검색할 수 없습니다. 요청 요약, 사용량 및 청구 기록은 계속 사용할 수 있을 수 있습니다. 필요한 세부 정보는 만료되기 전에 다운로드하세요.

만료된 캡처는 저장되지 않았거나 로드할 수 없었던 콘텐츠와는 다릅니다. 문제 해결 시 표시된 상태를 확인하세요.

생성된 미디어

TokenLab은 HTTP(S) 링크로 반환되는 지원되는 이미지, 비디오, 오디오 및 다운로드 가능한 3D 결과(Worlds 파일 포함)의 복사본을 자동으로 저장합니다. 이러한 결과에 대해 수신하는 모든 미디어 URL은 TokenLab URL입니다. API 응답, 작업 상태 읽기, task.completed 웹훅 resultUrls, 그리고 Seedance 호환 콜백 content.video_url 및 content.last_frame_url에서 확인할 수 있습니다.

https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…

확장자는 png, mp4, mp3 또는 glb와 같이 미디어 유형과 일치합니다. URL은 결과가 처음 기록된 시점부터 30일 동안 유효합니다. 다시 보거나, 재시도하거나, 작업 상태를 확인해도 해당 기간이 다시 시작되지는 않습니다.

URL은 수신 즉시 작동합니다. TokenLab이 복사본을 저장하는 동안 URL은 소스에서 TokenLab을 통해 파일을 스트리밍합니다. 복사본이 준비되면 URL은 해당 복사본을 제공합니다. 저장에 실패하면 URL은 결과 생성 후 최대 24시간 동안 소스에서 스트리밍한 다음 HTTP 410을 반환합니다.

더 오래 액세스하려면 파일을 사용할 수 있는 동안 다운로드하거나 Media Assets에 저장하세요. Media Assets에 저장된 복사본은 30일 자동 복사본과 함께 만료되지 않습니다.

자동 저장은 대화형 Worlds 페이지, 외부 참조 모델 종속성, 인라인 Base64 또는 바이너리 미디어, 입력 파일 또는 생성된 텍스트 내의 링크에는 적용되지 않습니다. 나중에 필요한 경우 이러한 결과는 직접 저장하세요. 작업 기록은 별도의 수명을 가지며, 작업이 완료되었다고 해서 미디어를 계속 사용할 수 있는 것은 아닙니다.

API를 통한 미디어 가용성 확인

AI 프로토콜 JSON 응답에는 지원되는 결과에 대한 media_retention이 포함됩니다. 여기에는 days 및 items가 포함되며, 각 항목은 url, kind, status(saved, saving, failed 또는 expired), expires_at 및 알려진 경우 content_type을 보고합니다. 응답 시간 제한 내에 저장 상태를 알 수 없는 경우 응답에서 media_retention이 생략되지만 미디어 URL은 계속 작동합니다. 미디어 결과 URL에 metadata=true를 추가하여 현재 상태를 확인할 수도 있습니다. 이 경우 status, expires_at, content_type 및 kind가 반환됩니다. saving 또는 failed 상태라고 해서 파일이 저장된 것은 아닙니다.

실패했거나 진행 중인 작업은 빈 미디어 URL 필드를 반환합니다.

미디어 결과 URL 응답의미조치 방법
404 media_not_found토큰 또는 파일 확장자가 결과와 일치하지 않음수신한 정확한 URL을 사용하세요
410 media_expired30일 기간이 종료되었거나 24시간 이상 전에 저장에 실패함TokenLab을 통해 파일을 더 이상 사용할 수 없음
502 또는 503 media_unavailable결과가 기록 중이거나 TokenLab이 바쁨Retry-After 지연 시간이 있는 경우 해당 시간 이후 또는 잠시 후 재시도하세요

이미지, 비디오 및 오디오 결과의 경우 미디어 결과 URL은 최대 5분 동안 지속되는 다운로드 URL로 리디렉션됩니다. 결과가 30일 창 내에 있는 동안 해당 링크가 만료되면 미디어 결과 URL을 다시 요청하세요. 이는 결과의 만료 기간을 연장하지 않습니다. 3D 파일은 미디어 결과 URL 자체에서 스트리밍됩니다.

TokenLab Agent (Assistant) 대화 기록

이는 내장된 TokenLab 어시스턴트와의 대화입니다. 이러한 대화는 API 요청 로그와 별도로 저장되며 해당 로그가 30일에 도달해도 자동으로 제거되지 않습니다. 대화에 이미 저장된 텍스트는 그대로 유지될 수 있지만, 만료된 요청 세부 정보 및 미디어는 해당 대화에서 다시 로드할 수 없습니다.

Agent 기록에서 대화를 제거할 수 있습니다. 이렇게 하면 기록 목록에서 제거되지만, 관련된 모든 데이터가 삭제되거나 요청, 청구, 지원 또는 Console 기록이 제거되지는 않습니다. 어시스턴트는 30일 창 내에 있는 경우에만 원본 요청 및 응답 콘텐츠를 조사할 수 있으며, 더 오래된 청구 및 사용량 기록은 계속 사용할 수 있을 수 있습니다.

기타 기록 및 파일

  • 계정 정보, 청구 및 사용량 기록, 작업 기록은 계정 서비스, 청구 및 지원을 제공하기 위해 별도로 보관됩니다. 이들의 보존 기간은 30일 요청 세부 정보 창으로 제한되지 않습니다.
  • 조직 통화 기록 내보내기 파일은 90일 동안 다운로드할 수 있습니다. 만료되기 전에 다운로드하세요. 내보내기 파일이 만료되어도 기본 기록은 삭제되지 않습니다.
  • Console 또는 TokenLab Agent (Assistant)에 업로드된 임시 파일은 24시간 동안 새 요청에 사용할 수 있습니다. 그 이후에는 새 요청에 사용해야 하는 경우 파일을 다시 업로드하세요.
  • 다운로드하거나 내보낸 파일, 브라우저 저장소 및 자체 애플리케이션이 저장한 복사본은 사용자가 제어합니다. TokenLab의 보존 제한은 해당 복사본을 삭제하지 않습니다.

위의 기간은 TokenLab을 통한 가용성을 설명합니다. 저장소에서의 삭제는 액세스 만료보다 늦게 완료될 수 있습니다. 요청을 처리하는 AI 서비스 제공업체는 자체 데이터 정책 및 보존 기간을 가지고 있습니다.

요청 문제 해결에 대한 내용은 로그 및 문제 해결을 참조하세요. 미디어 작업 폴링에 대한 내용은 비동기 작업 및 폴링을 참조하세요.

이 페이지의 내용