快速接入

通过以下Aidge产品快速接入介绍，迅速了解更多关于如何接入Aidge相关产品及其开发者控制台功能。

可通过以下 4 个步骤，快速设置您的账户并完成购买及接入 Aidge 产品：

如果您对 Aidge 相关产品及服务有任何疑问或需要我们提供帮助，请通过点击导航栏“联系我们”或发送电子邮件至 ([e-mail])。

步骤 1：账户设置

了解如何获取Aidge API的访问密钥（AccessKey）的流程。

首先，创建一个新的 Aidge 开发者账户（若已注册，则直接使用现有账户登录即可）。

然后，点击导航栏“获取API Key”控制台，选择“访问密钥”标签页，可获取您的密钥（AccessKey）。这里请注意保密您的密钥，请不要在公开分发的代码中使用密钥（AccessKey）。

步骤2：调试API

我们提供1000次免费试用配额，以帮助您熟悉和测试如何在您的产品中使用Aidge 产品。您可以在“API列表”页中查看您的试用配额的使用情况。

无论是初次试用Aidge API还是生产集成，强烈建议您在正式部署前先构建安全测试环境，全面验证功能稳定性和兼容性。

您可以通过以下两种方式测试您的 API 请求：

方法 1：登录 Aidge 控制台，在“API 调试”页面中，输入您想测试的 API 端点并填写参数后，您可以在调试框中查看相应的响应结果。

方法2：直接调用接口，体验试用，在您的代码中包含以下请求Header：

request.addHeaderParameter("x-iop-trial","true");

步骤3：发起初始API请求

目前，建议使用Java SDK来调用服务。Aidge的SDK提供了API请求封装、摘要签名、响应解析和消息监听等功能。通过使用该SDK，您可以轻松地发起API调用、检索API结果以及监控实时消息。以下是SDK的下载链接。

JAVA SDK的环境依赖要求Java SE/EE 1.5或更高版本。Python SDK要求Python 2.7或更高版本。

以下是 Java SDK 的示例代码。请注意：调用的 API 域名是https://cn-api.aidc-ai.com

Java

IopClient client = new IopClient("https://cn-api.aidc-ai.com", "your key", "your secret");
IopRequest request = new IopRequest();
// Adding this trial tag in header means using the trial resource to test, 
// please remove this ##trial tag after you purchased the API
request.addHeaderParameter("x-iop-trial","true")
request.setApiName("/ai/image/cut/out");
request.addApiParameter("simplify", "true");
//adding parameters as in the api doc we provide etc. I only listed one for example
request.addApiParameter("backGroundType", "WHITE_BACKGROUND");
request.addApiParameter("targetHeight", "1000");
request.addApiParameter("targetWidth", "800");
request.addApiParameter("imageUrl", "https://ae01.alicdn.com/kf/Sa78257f1d9a34dad8ee494178db12ec8l.jpg");
IopResponse response = client.execute(request, Protocol.GOP);
System.out.println(response.getBody());

Python

import iop

client = iop.IopClient("https://cn-api.aidc-ai.com", "your appKey", "your appSecret")
request = iop.IopRequest('/ai/image/cut/out')
request.set_protocol('GOP')
##Adding this trial tag in header means using the trial resource to test, please remove this ##trial tag after you purchased the API
request.add_header("x-iop-trial","true")
request.add_api_param('backGroundType', 'WHITE_BACKGROUND')
request.add_api_param('targetHeight', '1000')
request.add_api_param('targetWidth', '800')
request.add_api_param('imageUrl', 'https://ae01.alicdn.com/kf/Sa78257f1d9a34dad8ee494178db12ec8l.jpg')
response = client.execute(request)
print(response.type)
print(response.body)

步骤4：购买API

登录Aidge控制台后，您可以从API列表中购买所需的API。

在进入API订购页面后，点击蓝色按钮“立即购买”将跳转至下单页面，包括选择资源包方案等；

注意：目前Aidge只提供基于订阅的API资源包。如果您有批量订购的需求，请通过导航栏的联系我们或发送电子邮件至（[e-mail]）。

完成购买后，您可以在“订单管理”中查看当前订单，API列表也将会新增相应的API配额。