Skip to content

随意融合

Jump to bottom
墨图科技( MoreTo Technology Co.,Ltd) edited this page Aug 15, 2017 · 3 revisions
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.随意融合同步接口

url(get消息)：
 "http://api.ink-image.com:9001/rest/1.0/ink_image/v1/synthesis?AppKey="+Key+"&AppSecret="+Secret+"&contentUuid="+contentUuid+"&styleUuid="+styleUuid

参数说明：
 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.随意融合异步接口(慢滤镜)

url(get消息)：
 "http://api.ink-image.com:9001/rest/1.0/ink_image/v1/synthesis_asyn?AppKey="+Key+"&AppSecret="+Secret+"&contentUuid="+contentUuid+"&styleUuid="+styleUuid

参数说明：
 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)调用拉取图片接口