API 업로드용 TikTok 동영상 사양 (2026)
최종 확인일 · 출처는 이 페이지 하단에 있습니다
TikTok Content Posting API가 업로드 시 받는 동영상 콘텐츠 유형은 video/mp4, video/quicktime, video/webm 세 가지입니다. 최대 길이는 고정된 숫자가 아니라, Query Creator Info 엔드포인트가 크리에이터별로 max_video_post_duration_sec로 반환하는 값이며, 게시할 때마다 먼저 읽어야 합니다.
TikTok API가 받는 동영상 형식은?
업로드 엔드포인트에 문서화된 콘텐츠 유형은 video/mp4, video/quicktime, video/webm 세 가지입니다. 실제로는 H.264 영상과 AAC 오디오의 MP4가 무난한 기본값입니다. TikTok의 트랜스코딩이 가장 예측 가능하게 동작하는 조합이기 때문입니다.
| Content-Type | 컨테이너 | 참고 |
|---|---|---|
| video/mp4 | .mp4 | 기본값. TikTok 트랜스코딩을 거칠 때 H.264 + AAC가 가장 예측 가능한 조합. |
| video/quicktime | .mov | 지원. 같은 화질이면 대체로 용량이 커서, 영향을 받는 건 API가 아니라 전송. |
| video/webm | .webm | API는 지원. 휴대폰이나 편집 프로그램이 이 형식으로 내보내는 경우는 드묾. |
API를 통한 TikTok 동영상 최대 길이는?
정답이 하나가 아니며, 이것이 TikTok API에 관해 가장 흔히 잘못 알려진 사실입니다. 문서화된 방식은 상수가 아니라 필드입니다. Query Creator Info가 게시하려는 계정에 대해 max_video_post_duration_sec를 반환합니다.
“TikTok API 동영상 최대 길이”로 숫자 하나만 제시하는 페이지는 어떤 한 계정의 이야기를 하거나 추측하고 있는 것입니다. 올바른 구현은 계정마다, 게시마다 물어보고, 파일이 더 길면 클라이언트 쪽에서 업로드를 거부합니다.
분할 업로드는 어떻게 동작하나요?
URL 대신 파일을 TikTok에 직접 넘기면, init 호출에서 chunk_size와 total_chunk_count를 지정하고 파일을 조각으로 나눠 전송합니다.
TikTok 업로드 레퍼런스는 이 두 파라미터의 수치 범위를 공개하지 않으므로, 다른 곳에서 본 구체적인 숫자는 검증되지 않은 것으로 취급하세요. 문서가 분명히 밝히는 것은 형태뿐입니다. 먼저 분할 방식을 선언하고, 그다음 전송합니다.
API 문서에 화면비가 나오지 않는 이유는?
API가 화면비를 강제하지 않기 때문입니다. 1080 × 1920의 9:16은 배포상의 권장 사항이지 업로드 제약이 아닙니다. 정사각형이나 가로형 파일도 문제없이 업로드된 뒤, 전체 화면 세로 피드에서 레터박스로 재생됩니다. 오류가 나는 대신 시청 시간이 줄어드는 것입니다.
그래서 이 페이지의 사양 중 어떤 API 응답도 절대 알려 주지 않는 유일한 항목이고, 동영상 성과에 가장 큰 영향을 주는 항목이기도 합니다.
자주 묻는 질문
- TikTok Content Posting API가 받는 동영상 형식은?
- 문서화된 콘텐츠 유형은 video/mp4, video/quicktime, video/webm 세 가지입니다. H.264와 AAC의 MP4가 가장 예측 가능한 선택입니다.
- TikTok API로 게시할 수 있는 동영상 최대 길이는?
- 계정마다 다릅니다. Query Creator Info 엔드포인트가 크리에이터별로 max_video_post_duration_sec를 반환하며, 그 값이 해당 계정의 한도입니다. 공개된 단일 숫자는 없습니다.
- 9:16이 아닌 동영상은 TikTok API가 거부하나요?
- 아닙니다. 화면비는 업로드 제약이 아닙니다. 세로형이 아닌 동영상도 문제없이 업로드된 뒤 세로 피드에서 검은 띠와 함께 재생되며, 보통 시청 시간이 줄어듭니다.
- API로 게시한 TikTok 동영상이 나에게만 보이는 이유는?
- 감사를 통과하지 않은 API 클라이언트가 게시한 콘텐츠는 비공개 보기 모드로 제한되기 때문입니다. 이 제한은 공개 범위 필드를 바꿔서가 아니라, 클라이언트가 TikTok 감사를 통과하면 풀립니다.
출처
- TikTok for Developers — Content Posting API, Upload Video — 확인일 .
- TikTok for Developers — Query Creator Info — 확인일 .
- TikTok for Developers — Content Posting API, Direct Post — 확인일 .
이 수치는 다른 회사의 문서에서 가져온 것으로, 예고 없이 바뀔 수 있고 이 페이지가 자동으로 검증하지도 않습니다. 그래서 모든 출처에 확인한 날짜를 붙여 두었습니다. 이 페이지의 출처는 분기마다 다시 확인합니다.
이 페이지를 만든 방법: 이 페이지에 적힌 출처를 바탕으로 AI의 도움을 받아 작성. 출처 확인일 .