레퍼런스 · Rate limits

Photta API rate limits 그리고 매너 있게 polling하는 방법

한 줄 요약

Photta API는 고정 윈도우 내에서 API 키당 분당 600개의 요청을 허용합니다. 429 응답에는 Retry-After: 30이 포함됩니다. 작업은 3초마다 polling하십시오. 동시 작업 수는 플랜에 따라 제한됩니다.

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료 2026-09-10

공개된 제한 수치

문서에 명시된 레이트, 윈도우, 재시도, 이미지 크기 및 포맷입니다.

제한 사항

제출 시 409를 반환하기 전까지 한 번에 진행할 수 있는 배치의 수입니다.

플랜별 진행 중인 배치

Plan동시 처리

Free

동시 처리: 1

Hobby

동시 처리: 2

Seller

동시 처리: 3

Brand

동시 처리: 4

Studio

동시 처리: 6

고정 윈도우
제한은 고정 윈도우 내에서 API 키당 계산되며 모든 플랜에서 동일합니다. 두 개의 키는 두 개의 사용량을 의미합니다.
3초마다 polling
Polling은 유일한 완료 신호입니다. API는 웹훅을 전송하지 않습니다. 문서에 명시된 간격은 3초입니다. 이보다 빠르게 요청하면 빈 응답에 할당량을 낭비하게 됩니다.
지수 백오프 적용
429 응답을 받으면 Retry-After에 지정된 시간(초)만큼 대기한 후, 고정 주기로 재시도하지 말고 실패할 때마다 대기 간격을 늘리십시오.
배치 한도는 별도로 제한됨
rate limit은 요청 수를 계산하고, 동시성 한도는 처리 중인 작업 수를 계산합니다. 한도를 초과하는 배치는 429가 아닌 409를 반환합니다.

rate limit은 얼마인가요?

고정 윈도우 방식으로 API 키당 분당 600건의 요청이 허용됩니다. 문서상 모든 endpoint에 동일한 수치가 적용됩니다.

작업 polling은 얼마나 자주 해야 하나요?

3초마다 하십시오. 웹훅이 제공되지 않으므로, 작업 완료 여부를 확인하는 공식적인 방법은 polling입니다.

한 번에 얼마나 렌더링할 수 있나요?

처리 중인 배치는 플랜별로 제한됩니다: Free 1, Hobby 2, Seller 3, Brand 4, Studio 6. 한도를 초과하여 요청을 제출하면 409가 반환됩니다.

429 에러가 발생하면 어떻게 해야 하나요?

Retry-After 헤더를 확인하고 해당 시간(초)만큼 대기한 뒤 지수 백오프를 적용하여 재시도하십시오. 작업을 버리지 말고 큐에 넣으십시오.

이 페이지의 모든 수치는 다음 출처를 기반으로 합니다: Photta API 문서 · 확인 완료 2026-09-10

Photta API 키를 발급받고 위 cURL 스니펫을 붙여넣기만 하면, 커피가 다 내려지기도 전에 첫 번째 모델 착용 컷을 받아볼 수 있습니다.