所有 Aidge API 通用的基础信息：接入方式、鉴权、请求/响应规范、同步异步模型。开始集成前请先阅读本节。
基础 URL
站点 | 域名 |
中国站 |
|
国际站 |
|
响应格式
所有 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）
素材优化（11 个 SKU）
其他（2 个 SKU）
-- 商品标题 / 描述 / 关键词生成与改写。
件重尺审核 -- 物流包裹智能审核。
频率限制
每个 API 有独立的 QPS 上限。详见频率限制。