속도 제한

속도 제한은 API를 보호하고 모든 사용자에게 공정한 사용을 보장합니다.

속도 제한 처리

속도 제한을 초과하면 API는 rate_limit_error와 함께 429 상태 코드를 반환합니다:

{
    "error": {
        "code": 429,
        "message": "Rate limit exceeded",
        "type": "rate_limit_error",
        "fallback_suggestion": "retry after 60 seconds"
    }
}

권장 재시도 전략

429 응답을 받았을 때 지수 백오프를 구현하세요:

import time
import requests

def make_request_with_retry(url, headers, payload, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=payload)

        if response.status_code == 429:
            wait_time = 2 ** attempt * 30  # 30s, 60s, 120s
            print(f"Rate limited. Retrying in {wait_time}s...")
            time.sleep(wait_time)
            continue

        return response

    raise Exception("Max retries exceeded")

모범 사례

  • 429 응답에 대해 지수 백오프를 구현하세요
  • 빈번한 폴링 대신 callback_url (webhooks)을 사용하여 요청량을 줄이세요
  • 한꺼번에 요청을 보내지 말고 생성 요청 간격을 두세요
  • EvoLink 대시보드에서 크레딧 사용량을 모니터링하세요

더 높은 제한이 필요하신가요?

맞춤형 속도 제한과 전용 인프라에 대해서는 영업팀에 문의하세요.

관련 문서

얼리 액세스 신청