플랜 요건

REST와 MCP는 크리에이터(Creator) 플랜 이상이 필요합니다. 사용 조건을 충족하지 않는 워크스페이스는 403 PLAN_REQUIRED를 반환합니다. 유료 플랜이어도 현재 역할·작업 권한 검증은 적용됩니다.

레이트 리밋

REST 키와 MCP 토큰 각각 분당 30요청, 60초 고정 윈도우를 적용합니다. 초과하면 429 RATE_LIMITED입니다. 호출과 상태 조회에 간격을 두고 윈도우에 여유가 생긴 뒤 재시도하세요. 429를 받은 직후 반복 호출하지 마세요.

조직 사용량

API/MCP 사용량은 조직 단위로 집계합니다. 월 한도는 플랜과 결제 주기에 따라 다르므로 Posteady 설정의 API 사용량을 확인하세요. 적용되는 월 한도를 초과하면 429 QUOTA_EXCEEDED를 반환하며 분당 속도 제한과 달리 다음 결제 주기에 초기화됩니다.

같은 코드는 미디어 저장 공간 부족에도 사용됩니다. 오류 메시지로 요청 사용량과 저장 공간을 구분하세요. 업로드를 예약한 용량은 완료 확인 전에도 저장 공간에 포함됩니다. 재시도·상태 조회 역시 요청이며 사용량에 포함될 수 있습니다.

요청당 한도

대상	한도
텍스트 발행·예약	계정 1–5개, Threads·X 글 1–25개, LinkedIn 글 1개
TikTok·Instagram·YouTube·Facebook 발행·예약	계정 정확히 1개
리포스트	지원 계정 1개·원래 게시물 ID 1개
예약	현재부터 360일 이내 미래 시각
발행 게시물 조회	최근 90일 고정, `limit` 1–100·기본 20
미디어 목록	`limit` 1–100·기본 20, `offset` 0–10,000
JPEG 업로드	8 MiB
MP4·QuickTime 업로드	공용 라이브러리 최대 2 GiB
업로드 URL	300초 안에 PUT
업로드 완료 확인	예약 생성 후 24시간 이내

플랫폼별 글자 수·영상 길이·파일 크기는 플랫폼 가이드에 있습니다. 공용 라이브러리에 업로드할 수 있어도 플랫폼 발행 요건을 통과해야 합니다. 예를 들어 YouTube 영상 발행은 최대 500 MiB, Instagram·Facebook은 최대 1 GiB입니다.

플랫폼 자체 한도

소셜 플랫폼이 별도 발행·업로드 한도를 적용할 수 있습니다. Instagram의 한도 검증은 비동기 작업 실패로 나타나며 YouTube 일일 업로드·속도 제한은 PUBLISH_QUOTA_EXCEEDED로 나타날 수 있습니다. HTTP 응답과 함께 작업 오류를 확인하세요. 발행 작업의 상태를 참고하세요.

차단된 계정

차단된 사용자는 403 BLOCKED를 받습니다. 공통 응답 형식과 해결 방법은 오류와 부분 실패에서 확인하세요.

플랜·사용량·속도 제한