Seedance에서 invalid image format 오류가 발생하지만 브라우저에서는 링크가 열리는 경우

​

간단한 답변

The parameter `content[1]` specified in the request is not valid:
invalid image format (detected format); received: "".

​

실제 사례

https://<customer-domain>/api/v1/resource-download-grants/<file-id>/content?access_token=<signed token with an expiry>

​

이러한 링크가 존재하는 이유

• Range 미지원: 많은 서비스가 포맷을 감지하기 위해 Range 헤더로 시작 바이트를 먼저 요청하거나 청크 단위로 다운로드하여 미디어를 가져옵니다. 이러한 엔드포인트는 전체 파일만 반환하며 Range 요청에는 오류로 응답합니다
• 다운로드 횟수 제한: 제공자가 미디어를 가져올 때 사전 확인(probe)을 수행하고, 다운로드하며, 실패 시 재시도할 수 있으므로 반드시 한 번만 다운로드한다고 볼 수 없습니다. 제한 횟수를 모두 소진하면 응답으로 오류 JSON이 반환됩니다
• 짧은 만료 시간: 링크가 만료되면 반환되는 응답 또한 이미지가 아닙니다

​

이미지 전달 방식 선택

• 파일이 이미 오브젝트 스토리지(OSS, S3, R2 등)에 있다면, 스토리지 서비스에서 사전 서명된 URL을 생성하고 만료 시간을 최소 1시간 이상으로 설정하십시오. 사전 서명된 URL은 시간에 의해서만 만료되고, 다운로드 수 제한이 없으며, Range를 지원합니다
• 그렇지 않은 경우, 이미지를 공개 오브젝트 스토리지 버킷이나 CDN으로 복사한 후 Seedance에 새 URL을 전달하십시오

​

제출 전 링크 확인하기

# 1. Plain download: expect 200 and an image Content-Type such as image/png or image/jpeg
curl -s -o /dev/null -w 'code=%{http_code} type=%{content_type} size=%{size_download}\n' '<URL>'

# 2. Range download: expect 206 (or 200 with the full image), never a 4xx
curl -s -o /dev/null -w 'code=%{http_code} type=%{content_type}\n' -H 'Range: bytes=0-1023' '<URL>'

• 두 명령어 모두 JSON이나 HTML이 아닌 이미지를 반환하는지
• 다운로드 횟수 제한 없이 반복 다운로드가 계속 정상 작동하는지
• 쿠키, 로그인 세션 또는 추가 헤더가 필요하지 않은지
• 적어도 제출이 완료될 때까지, 이상적으로는 1시간 이상 링크가 유효하게 유지되는지
• 인트라넷 내부나 IP 허용 목록 뒤에 있지 않고 퍼블릭 인터넷에서 링크에 접근할 수 있는지

​

관련 문서