한도
Direct API의 요청 속도 한도, 이를 알려 주는 헤더, 그리고 크기 및 개수 한도를 알아봅니다.
요청 속도
| 버킷 | 한도 | 계산 단위 |
|---|---|---|
| 생성 작업 조회 | 생성 작업당 분당 30회, 전체 분당 1,200회 | API 키 |
무료 도구 호출(목록, 카탈로그, plan_media, 호출이 가져오는 각 미디어 URL) | 시간당 1,000회 | API 키 |
웹훅 관리(/webhooks와 그 하위 경로) | 분당 60회 | API 키 |
/usage, /me | 분당 60회 | API 키 |
API 키가 작동하지 않는 요청(401) | 10분당 60회. 이를 넘으면 해당 주소에서 오는 요청은 기간이 끝날 때까지 429(Retry-After 포함)로 응답합니다. 단, 최근 10분 안에 인증된 키는 제외됩니다 | 클라이언트 IP 주소(IPv6 주소는 /64 단위) |
| 유료 도구 호출 | 요청 속도 한도 없음 |
- 유료 호출은 속도가 아니라 금액으로 제한됩니다: 키의 크레딧 한도와 조직의 잔액입니다.
- 부하가 많을 때 생성 작업은 거부되지 않고
queued상태로 모델 처리 용량을 기다립니다. 모델이 동시에 실행할 수 있는 것보다 많은 작업을 시작하면 나중 생성 작업이 더 오래 걸릴 뿐, 실패하지는 않습니다. - 소리가 없는 동영상에 대한
video_remove_audio처럼 결과적으로 무료가 된 유료 호출은 무료 호출 버킷에 포함되어 계산됩니다.
속도 한도 응답
속도 한도가 적용되는 모든 엔드포인트는 다음 헤더를 반환합니다.
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760거부된 요청은 Retry-After: <seconds>와 다음 본문과 함께 429로 응답합니다.
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}재시도하기 전에 Retry-After초만큼 기다리세요. 429는 절대 청구되지 않습니다.
크기 및 개수 한도
| 한도 | 값 |
|---|---|
| 요청 본문 | 1 MB |
이미지 시작당 variations | 1~4 |
| 일괄 조회당 ID 수 | 10 |
wait | 45초 |
metadata | 키 20개. 키는 최대 40자, 값은 최대 500자 |
Idempotency-Key | 최대 200자, 24시간 동안 기억됨 |
| 조직당 활성 API 키 | 10 |
| 조직당 웹훅 엔드포인트 | 10 |
| 에셋 링크 유효 기간 | 만료 없음 |
| 모델별 입력(프롬프트 길이, 참조 이미지, 길이, 파일 크기) | 모델과 각 도구의 input_schema에 나열된 대로 |
문제가 있거나 궁금한 점이 있으면 언제든지 연락해 주세요. 기꺼이 도와드리겠습니다. 다음 주소로 이메일을 보내 주세요: support@morphic.com.