频率限制

默认 QPS 限制

默认 QPS 分三档：文本翻译 / 语种识别 / 文本纠错为 10；图片翻译 / 智能抠图 / 智能消除 / 智能裁剪 / 智能元素识别 / 尺码图检测 / 文档翻译为 5；其余为 2。如需更高 QPS，请联系技术支持。套餐等级不同，QPS 上限不同，高级套餐可能包含更高的 QPS 配额。

异步 API 并发

异步 API（文档翻译、智能出图、尺码图提取、商品素材优化 Lite / Pro）的 QPS 限制仅作用于提交接口。结果查询接口没有 QPS 限制，但建议轮询间隔不低于 1 秒（推荐 5 秒）。

推荐轮询策略

import time

def poll_task_result(query_func, task_id, interval=5, max_wait=600):
    """轮询异步任务，直到完成或超时。
    所有异步 SKU 经统一 QueryAsyncTaskResult 接口轮询，状态字段为 Data.Status，
    取值 QUEUED / IN_PROGRESS / COMPLETED / FAILED。
    下方代码同时兼容视频翻译 / 视频消除（一期暂缓）旧版 Data.TaskStatus = submitted/running/finished/failed。
    """
    TERMINAL = {"finished", "failed", "COMPLETED", "FAILED"}
    elapsed = 0
    while elapsed < max_wait:
        result = query_func(task_id)
        data = result.get("Data", {})
        status = data.get("TaskStatus") or data.get("Status") or ""
        if status in TERMINAL:
            return result
        time.sleep(interval)
        elapsed += interval
    raise TimeoutError(f"任务 {task_id} 在 {max_wait} 秒内未完成")

处理频率限制错误

收到 HTTP 429（限流）时：

1. 降低并发数量。

2. 实现带随机抖动的指数退避重试。

3. 如需提升 QPS 配额，请联系技术支持。

注意事项

• QPS 限制按账号维度，而非按 API Key 维度。

• 套餐等级决定 QPS 上限，高级套餐可能包含更高的 QPS 配额。

• 同步 API 的最大响应时间为 30 秒，客户端超时请据此设置。

后续步骤

• 错误码 -- 完整错误码参考。

• 文本翻译 -- 开始使用文本翻译。