图片翻译 Pro 版（异步）

4.1前置说明

图片翻译 Pro 版支持同步和异步两种调用方式。本文介绍异步调用接口，如需使用同步调用，请参阅图片翻译Pro版。

文本翻译及其他能力的异步接口共用结果获取流程、RocketMQ 订阅规则、消息加密协议、依赖配置，以及 Java 消费与解密代码。

异步调用的接入流程，订阅规则，消息格式与加密协议，以及详细的接入方案请参阅异步接口调用说明。

5.1.1 请求参数

⬆️ 表格中 IsAsync 为本次新增入参，标红待确认

5.1.2 请求示例

异步调用示例：

{
  "Async": true,
  "SourceLanguage": "auto",
  "IncludingProductArea": "true",
  "TranslatingBrandInTheProduct": "true",
  "ImageUrl": "https://img.alicdn.com/imgextra/i3/O1CN01HTDhDi28Fd85ZYs7H_!!6000000007903-0-tps-800-800.jpg",
  "TargetLanguage": "en",
  "UseImageEditor": "true"
}

5.1.3 响应参数

提交成功后，接口返回 Data.TaskId，不包含译文及最终用量信息。Success=true 仅表示提交调用成功，不代表翻译任务完成。请保存任务ID，并按照异步接口调用说明查询任务状态或接收结果通知。

5.1.4 异步模式响应示例

{
  "Data": {
    "TaskId": "task_20260614_abc123def456",
    "Status": "PENDING"
  },
  "RequestId": "72896D43-91D3-2AB4-AF66-3D4813D95C51",
  "Message": "Task submitted successfully",
  "Code": "success",
  "Success": true
}

5.2 限流与异常处理

• 接入技术方案规定，异步提交默认按主账号维度限流，默认 1 QPS；提高额度需提供 UID 并联系产品同学配置。

• QueryAsyncTaskResult 公开元数据配置为 5 次/秒，实际账号额度与维度以服务方配置为准。多个在途文本任务应统一管理查询频率，按业务可接受延迟设置间隔，对限流及暂时性错误采用退避与随机抖动，并设置本地等待上限；

• 外层调用失败时读取 Code、Message、RequestId；任务 FAILED 时读取实际业务结果中的失败信息。通用错误码参考错误码，不新增未验证错误码。提交重试可能创建新任务，现有资料未定义文本任务幂等提交参数或取消接口。

• 排障保留提交及查询 RequestId、TaskId、调用时间与状态，不记录完整待译文本、明文消息或密钥。通用消费确认、重投、幂等与查询兜底要求按公共接入文档执行。