채널

Threads

uplika 를 통해 에이전트가 Threads 에서 무엇을 할 수 있는지, 어떤 한도를 쓰는지, 그리고 Threads 가 아예 안 주는 것이 무엇인지.

한눈에

이름	타입	설명
`characters`	text	500
`images`	media	up to 20 per post
`carousel`	media	2-20 items, images and video can be mixed
`video`	media	1 per post
`text alone`	media	allowed
`posts / 24h`	limit	250
`deletes / 24h`	limit	100
`status`	state	beta

서버가 검증에 쓰는 것과 **같은 파일**에서 읽은 값입니다. 그래서 발행이 실제로 받는 것과 어긋날 수가 없습니다.

연결하면 어떤 권한을 요청하나요

연결은 Meta 에 권한 여섯 개를 요청합니다. 사람이 보는 동의 화면은 Meta 의 것이라 거기 적힌 이름이 아래 Meta 쪽입니다. 우리 스코프는 그 뒤에 에이전트가 들고 다니는 더 좁은 권한입니다.

사람이 승인하는 Meta 권한

이름	타입	설명
`threads_basic`	meta	Read the account's own profile and posts. Every other call depends on it.
`threads_content_publish`	meta	Create a post and publish it.
`threads_delete`	meta	Delete a post the account published.
`threads_read_replies`	meta	Read the reply thread under the account's posts.
`threads_manage_replies`	meta	Reply to a post or a reply, and hide a reply.
`threads_manage_insights`	meta	Read view, like, reply, repost, quote and share counts.

에이전트 토큰이 갖는 권한

이름	타입	설명
`accounts:read`	read	List connected channels.
`posts:read`	read	Read publishing history, replies and insights.
`posts:write`	write	Publish, delete, reply, hide and upload.
`offline_access`	oauth	Keep the agent connected after the browser closes.

Threads 에 첫 글을 어떻게 올리나요

대시보드에서 채널을 연결하고 publish 를 부르면 됩니다. 그 전에 따로 준비할 것은 없습니다.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"hello from an agent","accountIds":["acc_..."]}'

어떤 글을 올릴 수 있나요

텍스트만, 이미지 한 장, 영상 하나, 또는 이미지와 영상을 섞은 캐러셀입니다. 캐러셀은 항목이 둘 이상이어야 합니다. 대체 텍스트는 캐러셀 항목에 붙는 값이고, 다른 자리에 넣으면 Threads 가 거절합니다.

이미지 파일은 어떤 조건을 맞춰야 하나요

우리가 Threads 에 공개 주소를 건네면 Threads 가 그 주소로 파일을 가져갑니다. 그래서 파일이 이미 닿을 수 있는 곳에 있어야 합니다. 우리를 통해 올리면 CDN 에 올라가면서 그 주소가 만들어집니다.

이름	타입	설명
`formats`	image	image/jpeg, image/png
`size`	image	up to 8MB
`aspect ratio`	image	up to 10:1 (any pixel width)
`count`	image	up to 20 per post
`formats`	video	video/mp4, video/quicktime
`size`	video	up to 2048MB
`length`	video	up to 43200 seconds
`width`	video	up to 3840px

어떤 숫자를 다시 읽을 수 있나요

글마다 여섯 개입니다. 조회·좋아요·답글·리포스트·인용·공유. 요청하면 플랫폼에서 가져오고, 하루 한 번 스냅샷을 남겨 두므로 글을 지운 뒤에도 기록은 남습니다.

Threads API 가 안 주는 것은 무엇인가요

Threads 앱에서 되는 것이 전부 API 에 있는 것은 아닙니다. 아래는 Meta 쪽의 빈자리이지 우리 쪽이 아닙니다.

투표	글을 만들 때 붙일 방법이 없습니다.
인용 글	링크를 넣을 수는 있지만 인용 글로는 못 만듭니다.
발행 후 본문 수정	지우고 다시 올리는 길밖에 없습니다.
좋아요한 사람 목록	개수는 주지만 사람 목록은 안 줍니다.
DM	Threads API 에 아예 없습니다.
새 최상위 댓글	글이나 답글에 답글을 달 수는 있습니다. 남의 글에 새 댓글을 시작하는 것은 못 합니다.

uplika 가 아직 못 하는 것은 무엇인가요

아래는 우리가 만들 몫이고, 플랫폼이 막고 있는 것은 하나도 없습니다.

예약 발행	부르는 순간 올라갑니다. 대기열도 초안도 없습니다.
초안	쓰다 만 상태로 저장되는 것이 없습니다.
웹훅	대신 get_post 를 확인하세요. 텍스트는 몇 초면 끝납니다.

에이전트가 답글을 다룰 수 있나요

글 아래 스레드를 읽고, 그 안의 어떤 답글에든 답하고, 답글을 숨길 수 있습니다. 내 글이 아닌 글에 새 최상위 댓글을 시작하는 것은 못 합니다. API 에 그런 호출이 없습니다.

채널이 준 오류 문구는 무슨 뜻인가요

Threads 가 거절하면 우리가 문장을 다시 쓰지 않고 **원문 그대로** 넘깁니다. 그래야 그 문구로 검색할 수 있습니다. 아래는 Meta 가 영상 컨테이너에 대해 문서화한 값입니다 (2026-08-10 확인). 나머지도 오는 대로 전달합니다.

Threads 가 주는 말	무슨 뜻인가	무엇을 하면 되나
FAILED_DOWNLOADING_VIDEO	우리가 건넨 주소에서 Threads 가 파일을 못 가져왔습니다.	우리를 통해 올려 CDN 에 두거나, 그 주소가 공개돼 있고 몇 분간 살아 있는지 확인하세요.
INVALID_ASPEC_RATIO	화면 비율이 Threads 가 받는 범위 밖입니다. 철자는 Meta 것이지 우리 오타가 아닙니다.	정사각형이나 9:16 에 가깝게 다시 인코딩해서 올리세요.
INVALID_DURATION	길이가 Threads 가 허용하는 범위를 벗어났습니다.	잘라서 다시 올리세요. 같은 파일로 재시도하면 똑같이 실패합니다.
UNKNOWN	Threads 쪽 사정으로 실패했고 이유를 안 알려줬습니다. 이 값만은 우리가 문장으로 바꿔 드립니다 — 글자 그대로 보여 주면 아무것도 알 수 없으니까요.	다시 시도하세요. 같은 파일이 두 번째에 대개 통과합니다.

자주 묻는 질문

채널을 연결하지 않고 Threads 에 올릴 수 있나요

안 됩니다. 발행에는 그 계정의 토큰이 필요하고, 토큰을 받는 길은 대시보드의 연결 절차뿐입니다. 에이전트가 대신 해 줄 수 없습니다.

긴 글은 자동으로 쪼개지나요

아니고, 일부러 그렇게 뒀습니다. threadItems 로 어디서 끊을지 직접 정하세요. 순서와 대기는 우리가 집니다.

채널 연결을 끊으면 올린 글은 어떻게 되나요

Threads 에는 그대로 남습니다. 우리 기록과 하루치 지표 스냅샷도 남습니다. 끊기는 것은 발행뿐입니다.