References

파일 유형 및 제한

Atoms에 파일을 추가하기 전에 크기 및 형식 요구 사항을 확인하세요. 제한은 업로드 위치에 따라 달라집니다. 채팅 첨부파일, Design 이미지, 앱 브랜딩, 프로필 이미지는 각각 다른 규칙이 적용됩니다.

업로드, 미리보기, 처리는 서로 별개입니다. 업로드가 성공했다고 해서 Atoms가 미리보기를 표시할 수 있거나 에이전트가 파일의 모든 내용을 읽고 사용할 수 있다는 보장은 없습니다.

채팅 첨부파일 및 폴더 제한

업로드 위치 또는 작업	제한	예상되는 동작
홈 페이지 또는 프로젝트 채팅에서 동영상을 포함한 파일 첨부	파일당 100 MB	제한을 초과한 파일은 건너뜁니다. 다른 유효한 파일은 계속 업로드할 수 있습니다.
홈 페이지 또는 프로젝트 채팅 업로드 영역에 폴더 드래그	폴더 드롭당 파일 500개 및 중첩 10단계	둘 중 하나라도 제한을 초과하면 전체 폴더 드롭이 취소됩니다. 파일 수를 줄이거나 폴더 구조를 단순화한 뒤 다시 시도하세요.

폴더 드롭 제한은 메시지당 일반 첨부파일 제한이 아닙니다. 폴더 안의 각 파일에도 채팅의 파일당 크기 제한이 적용됩니다. 이 규칙은 채팅 업로드 영역에 대한 설명이며, 별도의 파일 패널 업로드나 게시된 앱의 방문자가 제출한 파일에는 해당하지 않습니다.

크기 단위는 Atoms에 표시된 단위를 사용합니다. 이 확인에서는 1 MB를 1,048,576바이트로 계산합니다. 명시된 최대값과 정확히 같은 크기의 파일은 크기 제한 이내이며, DOCX 미리보기 예외는 아래에 설명되어 있습니다.

동영상 업로드

홈 페이지 또는 프로젝트 채팅에 첨부된 동영상 파일에도 동일한 파일당 100 MB 제한 이 적용됩니다. 동영상이 100 MB보다 크면 업로드되지 않습니다. 파일 크기를 줄인 뒤 다시 시도하세요.

기본 제공 동영상 미리보기는 브라우저 및 인코딩 호환성에 따라 MP4, WebM, MOV를 지원합니다. 크기 제한 이내로 업로드했다고 해서 동영상의 길이, 해상도 또는 인코딩이 재생이나 AI 처리에 지원된다는 보장은 없습니다. 이 첨부파일 제한은 별도의 동영상 편집기 가져오기나 모델별 참조 동영상의 제한을 정하는 것은 아닙니다.

미리볼 수 있는 파일 유형

다음 형식은 기본 제공 미리보기를 지원합니다. 이는 미리보기 참고용이며, 업로드가 허용되거나 AI 처리에 지원되는 형식의 전체 목록은 아닙니다.

파일 범주	미리보기 형식	참고
이미지	.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .avif, .ico	이미지 업로드 도구는 더 좁은 형식 목록을 가질 수 있습니다. 아래의 추가 제한을 확인하세요.
문서	.pdf, .docx	DOCX 미리보기는 10 MB보다 작은 파일이 필요합니다. 해당 크기 이상인 DOCX 파일은 업로드에는 성공할 수 있지만 기본 제공 DOCX 미리보기를 사용할 수 없습니다.
스프레드시트 및 표 형식 데이터	.xlsx, .csv	미리보기 지원이 모든 스프레드시트 기능의 재현을 보장하는 것은 아닙니다.
텍스트, Markdown, 코드 및 구성	.txt, .md 및 .js, .ts, .jsx, .tsx, .vue, .html, .css, .py, .json, .yaml, .xml, .sql, .sh를 포함한 일반적인 소스/구성 형식	표시된 코드/구성 확장자는 예시이며 전체 목록은 아닙니다.
노트북 및 다이어그램	.ipynb, .mmd, .mermaid	Notebook 및 Mermaid 미리보기 형식입니다.
오디오	.mp3, .wav, .ogg, .aac, .flac	재생은 브라우저 및 인코딩 지원 여부에도 좌우됩니다.
동영상	.mp4, .webm, .mov	재생은 브라우저 및 인코딩 지원 여부에도 좌우됩니다.

기본 제공 미리보기가 없는 파일

일부 파일 형식은 업로드할 수 있지만 직접 미리볼 수는 없습니다. 예를 들면 다음과 같습니다.

압축 파일: ZIP, RAR, 7Z, TAR
Office 파일: DOC, XLS, PPT, PPTX
문서 형식: EPUB, RTF
Design 파일: PSD, AI, FIG, Sketch
이미지 및 미디어: HEIC, HEIF, TIFF, AVI, MKV, M4A

미리보기가 없다고 해서 그 자체만으로 업로드가 실패했다는 뜻은 아닙니다.

업로드한 파일에 미리보기가 없다면 파일을 다운로드하여 호환되는 애플리케이션에서 여세요. 폴더에는 개별 파일 미리보기가 없으므로 대신 폴더 안의 파일을 여세요.

추가 이미지 및 스토리지 업로드 제한

사용 중인 특정 도구의 제한을 따르세요. 채팅 제한 이내인 파일이라도 이러한 이미지 컨트롤 중 하나에는 너무 클 수 있습니다.

업로드 위치	이미지당 최대 크기	형식
Design → 이미지 라이브러리 → Upload	4 MB	JPEG (.jpg, .jpeg), PNG, GIF, BMP, TIFF (.tif, .tiff), WebP
Design → 비주얼 에디터 → 이미지 선택 → 이미지 도구 → Upload	5 MB	파일 선택기에서는 PNG, JPG/JPEG, GIF, BMP, WebP를 제공합니다.
앱 로고	5 MB	PNG, JPEG
소셜 미리보기 이미지	5 MB	PNG, JPEG, WebP
프로필 사진	2 MB	PNG, JPEG
워크스페이스 이미지 — 데스크톱	5 MB	PNG, JPEG, WebP
워크스페이스 이미지 — 모바일	5 MB	PNG, JPEG, WebP, SVG
App 월드 게시 커버	3 MB	브라우저에서 이미지로 인식되는 이미지 파일

Design 이미지 라이브러리 업로더는 TIFF를 허용하지만, 위의 일반 파일 미리보기 이미지 형식에는 포함되지 않습니다.

Atoms 클라우드 스토리지: 클라우드 스토리지 패널을 통해 파일을 업로드할 때는 파일당 100 MB 제한이 적용됩니다. 이는 채팅 첨부파일 및 총 스토리지 허용량과는 별개입니다. 또한 게시된 앱에 직접 구축한 업로드 기능의 제한을 정하는 것은 아닙니다.

기타 파일 처리 동작

읽을 수 없는 이미지. 채팅 업로드는 일반적인 비트맵 이미지의 읽기 가능 여부를 확인합니다. 이미지를 읽을 수 없으면 건너뛰고 유효한 이미지를 제공하라는 안내가 표시됩니다. 다시 시도하기 전에 원본을 로컬에서 열어 새 복사본으로 내보내세요.

길게 붙여넣은 텍스트. 채팅 에디터에 붙여넣은 텍스트는 50줄 또는 2,000자에 도달하면 TXT 첨부파일로 바뀔 수 있습니다. 이는 자동 첨부파일 변환 기준이며, 문서 길이의 최대값은 아닙니다.

에이전트와 파일 사용. 미리보기는 파일을 표시할 수 있다는 것만 확인해 줍니다. 오디오 전사, 압축 파일 추출, 스캔된 페이지 읽기, 복잡한 문서의 모든 요소 해석까지 지원된다는 뜻은 아닙니다.

파일이 거부되거나 사용할 수 없는 경우

발생한 상황	해야 할 일
파일이 너무 큼	해당 업로드 위치의 제한을 확인하세요. 가능하다면 압축하거나 더 작은 사본으로 내보내고, 내용을 더 작은 파일로 나누세요. 원본은 보관하세요.
폴더 드롭이 파일 수 또는 중첩 제한을 초과함	폴더를 더 작은 그룹으로 나누거나 중첩된 하위 폴더를 줄인 뒤 다시 시도하세요. 거부된 폴더 드롭은 부분적으로 업로드되지 않습니다.
이미지 도구가 형식을 거부함	해당 도구에 나열된 형식 중 하나로 이미지를 내보내세요. 파일 확장자 이름만 바꾼다고 파일이 변환되지는 않습니다.
Atoms가 잘못되었거나 읽을 수 없는 이미지라고 보고함	이미지가 로컬에서 열리는지 확인하세요. 이미지 애플리케이션에서 다시 내보내거나 새 복사본을 구한 뒤 다시 업로드하세요.
“파일이 업로드되었지만 미리보기를 사용할 수 없음”	업로드는 성공했을 수 있습니다. 위의 미리보기 형식과 DOCX 미리보기 크기 제한을 확인하거나, 파일을 다운로드해 로컬에서 여세요.
오디오 또는 동영상 미리보기가 재생되지 않음	로컬 재생 및 브라우저 호환성을 확인하세요. 필요하면 브라우저 호환 인코딩과 나열된 미리보기 형식 중 하나로 다시 내보내세요.
에이전트가 업로드된 파일을 예상대로 사용할 수 없음	에이전트가 사용하길 원하는 내용을 구체적으로 지정하세요. 가능하다면 원본 파일의 복잡한 레이아웃에 의존하기보다 관련 텍스트나 더 단순한 내보내기 파일을 제공하세요.
오류가 스토리지 용량을 가리킴	관련 스토리지 사용량과 허용량을 확인하세요. 총 용량 문제는 단일 파일의 크기 제한 초과와는 다릅니다.

문제가 계속되면 [email protected] 로 Atoms 지원팀에 문의하세요. 업로드 위치, 파일 확장자, 파일 크기, 정확한 오류 메시지를 포함해 주세요. 필요하지 않은 한 민감한 파일 내용은 공유하지 마세요.