{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Rate Limit","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rate-limit","__idx":0},"children":["Rate Limit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To ensure fair usage and prevent abuse, our API implements rate limiting. There are two types of rate limits:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"per-ip-address","__idx":1},"children":["Per IP Address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each IP address is limited to a maximum of 250 requests per 300 seconds. Exceeding this limit will result in a 429 Too Many Requests error."," ","Recommended pacing: ~5 requests per second (5 QPS) to avoid latency spikes."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"per-access-token","__idx":2},"children":["Per Access Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each access token is limited to a maximum of 250 requests per 300 seconds. Exceeding this limit will result in a 429 Too Many Requests error."," ","Recommended pacing: ~5 requests per second (5 QPS) to avoid latency spikes."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both conditions must be met for a request to be accepted. If either condition is not met, the request will receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}," error. Please note that each query related to unit will be processed real-time. Other APIs can use the access token util expired."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is recommended that you handle rate limit errors gracefully in your application by implementing the appropriate backoff and retry mechanisms."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Rate Limit","id":"rate-limit","depth":1},{"value":"Per IP Address","id":"per-ip-address","depth":3},{"value":"Per Access Token","id":"per-access-token","depth":3}],"frontmatter":{"seo":{"title":"Rate Limit"}},"lastModified":"2026-07-02T07:29:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/develop/rate_limit","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}