Cyprex API

速率限制

API 请求根据您的套餐进行速率限制。每个响应都包含速率限制头以帮助您跟踪使用情况。

各套餐限制

套餐请求数/分钟请求数/天
Free101,000
Basic6010,000
Pro300100,000
EnterpriseCustomCustom

响应头

每个响应都包含速率限制信息：

头字段描述
X-RateLimit-Limit每个窗口最大请求数
X-RateLimit-Remaining当前窗口剩余请求数
X-RateLimit-Reset窗口重置的 Unix 时间戳
Retry-After等待秒数（仅在 429 响应中）

处理速率限制

当超出速率限制时，API 返回 429 状态码。使用 Retry-After 头实现指数退避：

示例

import requests
import time

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

        if response.status_code == 429:
            retry_after = int(
                response.headers.get("Retry-After", 60)
            )
            print(f"Rate limited. Retrying in {retry_after}s...")
            time.sleep(retry_after)
            continue

        return response

    raise Exception("Max retries exceeded")