Aidge API 提供基于 HTTPS 的多模态翻译和素材优化服务，支持同步异步调用、HMAC-SHA256 签名鉴权及统一 JSON 响应格式。-阿里云帮助中心

基础 URL

站点	域名
中国站	`https://cn-api.aidc-ai.com`
国际站	`https://api.aidc-ai.com`

所有接口以 /rest 为前缀拼接到基础 URL 上。完整请求 URL 示例：

https://cn-api.aidc-ai.com/rest/ai/text/marco/translator?partner_id=aidge&sign_method=sha256&sign_ver=v2&app_key=<your-key-name>&timestamp=<timestamp>&sign=<signature>

请求格式

协议：HTTPS
方法：支持 GET 和 POST（建议所有调用使用 POST）
Content-Type：application/json
鉴权：阿里云 AccessKey (AK/SK)，使用 HMAC-SHA256 算法签名后通过 URL 查询参数传递。详见鉴权方式。

试用模式：使用试用额度时，添加请求头 x-iop-trial: true。完整公共参数详见公共参数。

响应格式

所有 API 返回统一结构的 JSON 对象，包含 Code、Message、RequestId、Data、Success 字段。字段定义详见公共参数 - 公共响应字段。

成功响应示例：

{
  "Code": "success",
  "Message": "Success",
  "RequestId": "2157065A-D6C8-1F3E-A4D0-B1234567890",
  "Data": { "TranslatedText": "..." }
}

错误响应示例：

{
  "Code": "InvalidParameter",
  "Message": "请求参数错误: SourceLanguage",
  "RequestId": "2157065A-D6C8-1F3E-A4D0-B1234567890",
  "Data": null
}

所有 Aidge API 共享统一的命名错误码（如 InvalidParameter、FreeQuotaExhausted、InputContentBlocked）。完整错误码列表及排查方法，请参见错误码。

同步与异步 API

类型	模式	适用 API
同步	单次请求，即时返回结果	文本翻译、文本纠错、语种识别、图片翻译（标准版 + Pro 版）、智能抠图、智能消除、智能裁剪、智能元素识别、尺码图检测、商品类目匹配、商品类目属性匹配、件重尺审核、文案优化
异步	提交任务后轮询结果	文档翻译、智能出图、尺码图提取、商品素材优化 Lite / Pro、视频翻译、视频消除

异步 API 需先调用提交接口获取 TaskId，再通过统一的异步结果查询接口轮询任务状态，直到 Status 为 COMPLETED 或 FAILED。

异步结果查询接口（POP 网关 API 名称 QueryAsyncTaskResult）的完整契约——含请求参数、响应参数（Data.Status / Data.Result / Data.UsageMap / Data.extraInfo）、响应示例、注意事项——详见独立文档异步结果查询接口。

SKU 全清单

Aidge 平台共提供 20 个 API SKU，按业务能力划分为以下三大类：

多模态翻译（7 个 SKU）

文本翻译 -- 100+ 语向，含桥接。
文档翻译 -- PDF / Word，保留排版。
图片翻译标准版 / Pro 版 -- 翻译图片内嵌文字；Pro 版基于多模态大模型，翻译质量更高并支持编辑器布局信息。
视频翻译 -- 音视频全链路。
视频消除 -- 视频画面文字消除与区域内容去除。
语种识别 -- 24 个语向自动识别。
文本纠错 -- 14 个语向拼写纠错。

素材优化（11 个 SKU）

商品素材优化 Lite -- 最低成本工作流。
商品素材优化 Pro -- 最好效果工作流。
智能出图 -- 异步编排 7 项原子能力。
智能抠图 -- 同步去背景。
智能消除 -- 同步消除文字 / 特定名称 / 透明字块 / 牛皮癣。
智能裁剪 -- 按目标尺寸智能裁剪。
智能元素识别 -- 识别文字 / Logo / 水印 / 含字色块。
尺码图提取 -- 异步从图片提取结构化尺码表。
尺码图检测 -- 同步检测图片是否含尺码图。
商品类目匹配 -- 同步匹配铺货平台类目。
商品属性匹配 -- 同步类目 + 属性填写。

其他（2 个 SKU）

文案优化（废弃） -- 商品标题 / 描述 / 关键词生成与改写。
件重尺审核 -- 物流包裹智能审核。

频率限制

每个 API 有独立的 QPS 上限。详见频率限制。