随意融合
Clone this wiki locally
1.图片上传接口
url(post消息):
"http://api.ink-image.com:9001/rest/1.0/ink_image/v1/upload?AppKey="+Key+"&AppSecret="+Secret+"&imageBody="+imageBody
参数说明:
Key:墨图科技分配给客户的唯一标识符
Secret:墨图科技分配给客户的唯一标识符
imageBody:经过Base64、URL编码后的图片内容
返回消息:
{"code":"Proc Succ","tagid":"42532ac6-67a2-4405-8995-3d99d6b80266"}
tagid是图片在服务器的uuid
使用例子(以java为例):
String server = "http://api.ink-image.com:9001/";
String imageBody = Base64.encode(readFile("test.jpg"));
imageBody = URLEncoder.encode(imageBody, "utf-8");
//发送post消息函数需要用户实现
HttpRequest.sendPost(server + "rest/1.0/ink_image/v1/upload", "AppKey=123456&AppSecret=U6VEsPIZXL35BmWaAEnsHZUv&imageBody="+imageBody);
2.随意融合同步接口
参数说明:
Key:墨图科技分配给客户的唯一标识符
Secret:墨图科技分配给客户的唯一标识符
contentUuid:原始图片在服务器的uuid,一般由服务器在上传接口返回的tagid
styleUuid:风格化图片在服务器的uuid,一般由服务器在上传接口返回的tagid
返回消息:
{"code":"Proc Succ","tagid":"974f8c51-0b98-44ef-97ce-366bfc8968e3afbbdad8-5c96-4b0a-a20a-9a779fe286e5"}
tagid是自定义风格化生成图片在服务器的uuid
使用例子(以java为例):
String server = "http://api.ink-image.com:9001/";
String contentUuid = "42532ac6-67a2-4405-8995-3d99d6b80266";
String styleUuid = "42532ac6-67a2-4405-8995-3d99d6b80267";
//发送get消息函数需要用户实现
HttpRequest.sendGet(server + "rest/1.0/ink_image/v1/synthesis", "AppKey=123456&AppSecret=U6VEsPIZXL35BmWaAEnsHZUv&contentUuid="+contentUuid+"&styleUuid="+styleUuid);
3.随意融合异步接口(慢滤镜)
参数说明:
Key:墨图科技分配给客户的唯一标识符
Secret:墨图科技分配给客户的唯一标识符
contentUuid:原始图片在服务器的uuid,一般由服务器在上传接口返回的tagid
styleUuid:风格化图片在服务器的uuid,一般由服务器在上传接口返回的tagid
返回消息:
{"code":"Proc Succ","tagid":"974f8c51-0b98-44ef-97ce-366bfc8968e3afbbdad8-5c96-4b0a-a20a-9a779fe286e5"}
tagid是自定义风格化处理后,即将生成图片在服务器的uuid。注意:此接口返回时,uuid代表的图片还未生成,还需要调用查询接口查看随意融合接口是否处理完成
使用例子(以java为例):
String server = "http://api.ink-image.com:9001/";
String contentUuid = "42532ac6-67a2-4405-8995-3d99d6b80266";
String styleUuid = "42532ac6-67a2-4405-8995-3d99d6b80267";
//发送get消息函数需要用户实现
HttpRequest.sendGet(server + "rest/1.0/ink_image/v1/synthesis_asyn", "AppKey=123456&AppSecret=U6VEsPIZXL35BmWaAEnsHZUv&contentUuid="+contentUuid+"&styleUuid="+styleUuid);
4.随意融合异步查询接口(慢滤镜查询)
url(get消息):
"http://api.ink-image.com:9001/rest/1.0/ink_image/v1/synthesis_query?AppKey="+Key+"&AppSecret="+Secret+"&uuid="+uuid
参数说明:
Key:墨图科技分配给客户的唯一标识符
Secret:墨图科技分配给客户的唯一标识符
uuid:慢滤镜目标图片uuid,一般是慢滤镜异步接口返回的uuid
返回消息:
1.处理成功:http返回200;返回消息:{"code":"Proc Succ","tagid":"42532ac6-67a2-4405-8995-3d99d6b8026642532ac6-67a2-4405-8995-3d99d6b80267"}
tagid是自定义风格化处理后生成的图片在服务器的uuid,可以正常拉取图片
2.处理失败:http返回400,表示对应的慢滤镜请求失败了
3.还在处理中:http返回202,表示慢滤镜还未处理完成,正在处理中
使用例子(以java为例):
String server = "http://api.ink-image.com:9001/";
String uuid = "42532ac6-67a2-4405-8995-3d99d6b8026642532ac6-67a2-4405-8995-3d99d6b80267";
//发送get消息函数需要用户实现
HttpRequest.sendGet(server + "rest/1.0/ink_image/v1/synthesis_asyn", "AppKey=123456&AppSecret=U6VEsPIZXL35BmWaAEnsHZUv&uuid="+uuid);
4.拉取图片接口
url(get消息):
"http://api.ink-image.com:9002/rest/1.0/ink_image/v1/get_image?AppKey="+Key+"&uuid="+uuid
参数说明:
Key:墨图科技分配给客户的唯一标识符
uuid:图片在服务器的uuid,一般由服务器在别的接口(比如图片上传、滤镜、随意融合、超分辨率等接口)返回的tagid
返回消息:
返回图片
随意融合同步处理典型应用场景调用说明
(1)调用上传接口上传原始图片
(2)调用上传接口上传风格化图片
(3)调用随意融合同步接口
(4)调用拉取图片接口
随意融合(慢滤镜)典型应用场景调用说明
(1)调用上传接口上传原始图片
(2)调用上传接口上传风格化图片
(3)调用随意融合异步接口
(4)while(查询次数){
调用随意融合异步查询接口
}
(5)调用拉取图片接口