首次接入API的操作说明

本文档主要提供API调用所需要 SDK下载入口及操作说明。

在获取 AccessKey 和 AccessKey Secret后，我们即可开始调用API进行调试或使用。

首先，您需要先下载 SDK，建议使用 Java SDK 调用服务。Aidge 的 SDK 提供了 API 请求封装、摘要签名、响应解析和消息监听等功能。通过使用这个 SDK，您可以轻松地进行 API 调用、获取 API 结果以及监控实时消息。

下载SDK

选择您需要的开发语言并下载相应的SDK。

JAVA SDK	PYTHON SDK
Updated Time 2023-10-23	Updated Time 2023-10-23
Download	Download

示例代码

获取SDK后，即可进行API调用请求，以下是使用Java SDK调用我们的API的示例代码，可参考（以图像裁剪API为例）：

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)