API 调用快速体验

前提条件

• 已开通 Aidge 文本翻译功能的阿里云账号。请参见准备工作。

• AccessKey 对（AccessKey ID 和 AccessKey Secret）。请参见准备工作 - 步骤四。

• Python 3.6+ 及 requests 库，或 cURL。

Python 示例

import os
import time
import hashlib
import hmac
import json
import requests

# 从环境变量读取凭证
ACCESS_KEY_NAME = os.environ["AIDGE_ACCESS_KEY_NAME"]
ACCESS_KEY_SECRET = os.environ["AIDGE_ACCESS_KEY_SECRET"]

# API 端点
# 中国站:"cn-api.aidc-ai.com"
# 国际站:"api.aidc-ai.com"
API_DOMAIN = "cn-api.aidc-ai.com"


def call_aidge_api(api_name: str, payload: dict, use_trial: bool = True) -> dict:
    """使用阿里云 AccessKey (AK/SK) 调用 Aidge API。"""
    timestamp = str(int(time.time() * 1000))

    # 用 HMAC-SHA256 计算 AK/SK 签名
    sign_string = ACCESS_KEY_SECRET + timestamp
    signature = hmac.new(
        ACCESS_KEY_SECRET.encode("utf-8"),
        sign_string.encode("utf-8"),
        hashlib.sha256,
    ).hexdigest().upper()

    url = (
        f"https://{API_DOMAIN}/rest{api_name}"
        f"?partner_id=aidge&sign_method=sha256&sign_ver=v2"
        f"&app_key={ACCESS_KEY_NAME}&timestamp={timestamp}&sign={signature}"
    )

    headers = {
        "Content-Type": "application/json",
        "x-iop-trial": str(use_trial).lower(),
    }

    response = requests.post(url, data=json.dumps(payload), headers=headers)
    return response.json()


# --- 翻译文本 ---
result = call_aidge_api(
    api_name="/ai/text/marco/translator",
    payload={
        "SourceLanguage": "zh",
        "TargetLanguage": "en",
        "text": "跨境电商智能翻译解决方案",
    },
)

print(json.dumps(result, indent=2, ensure_ascii=False))

运行示例

将上述代码保存为 translate.py，然后执行以下命令：

export AIDGE_ACCESS_KEY_NAME="your-access-key-name"
export AIDGE_ACCESS_KEY_SECRET="your-access-key-secret"
pip install requests
python translate.py

cURL 示例

# 设置凭证
AK_NAME="your-access-key-name"
AK_SECRET="your-access-key-secret"
TIMESTAMP=$(date +%s000)

# 用 HMAC-SHA256 计算 AK/SK 签名
SIGN=$(echo -n "${AK_SECRET}${TIMESTAMP}" \
  | openssl dgst -sha256 -hmac "${AK_SECRET}" \
  | awk '{print toupper($2)}')

# 调用文本翻译 API
curl -X POST \
  "https://cn-api.aidc-ai.com/rest/ai/text/marco/translator?partner_id=aidge&sign_method=sha256&sign_ver=v2&app_key=${AK_NAME}&timestamp=${TIMESTAMP}&sign=${SIGN}" \
  -H "Content-Type: application/json" \
  -H "x-iop-trial: true" \
  -d '{
    "SourceLanguage": "zh",
    "TargetLanguage": "en",
    "text": "跨境电商智能翻译解决方案"
  }'

解析响应

成功响应的结构如下：

{
  "Code": "Success",
  "Message": "ok",
  "RequestId": "abc123...",
  "Data": {
    "TranslatedText": "Intelligent translation solution for cross-border e-commerce"
  }
}

通过响应体的 Code 字段判断调用结果。"Success" 表示成功；失败时 Code 为命名错误码（如 InvalidParameter、FreeQuotaExhausted），详见错误码。RequestId 是排查问题的关键标识。

使用试用额度

将 x-iop-trial 请求头设置为 "true" 即可使用免费试用额度。使用正式额度时，设置为 "false"。

如果将 x-iop-trial 设置为 "false" 且无可用额度，API 返回以下错误：

Sorry, your calling resources have been exhausted.

常见错误

后续步骤

• 图片翻译 API——通过 API 翻译商品图片。

• 支持的语言——完整的语言对列表。

• 计费概述——价格和计费详情。