{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-TW/develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"速率限制","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":"速率限制","__idx":0},"children":["速率限制"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["為了確保公平使用並防止濫用，我們的 API 實作了速率限制。速率限制分為兩種："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"依-ip-位址","__idx":1},"children":["依 IP 位址"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["每個 IP 位址每 300 秒最多 250 個請求。超過此限制將會產生 429 Too Many Requests 錯誤。"," ","建議節奏：約每秒 5 個請求（5 QPS），以避免延遲飆升。"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"依-access-token","__idx":2},"children":["依 Access Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["每個 access token 每 300 秒最多 250 個請求。超過此限制將會產生 429 Too Many Requests 錯誤。"," ","建議節奏：約每秒 5 個請求（5 QPS），以避免延遲飆升。"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["一個請求必須同時符合上述兩個條件才會被接受。若任一條件未符合，請求將會收到 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}," 錯誤。請注意，每個與點數相關的查詢都會即時處理。其他 API 可使用 access token 直至其到期。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["建議您在應用程式中妥善處理速率限制錯誤，實作適當的退避與重試機制。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"速率限制","id":"速率限制","depth":1},{"value":"依 IP 位址","id":"依-ip-位址","depth":3},{"value":"依 Access Token","id":"依-access-token","depth":3}],"frontmatter":{"seo":{"title":"速率限制"}},"lastModified":"2026-10-30T07:26:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/develop/rate_limit","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}