API专区

专业的API产品、完善的服务体系、确保您获得稳定、安全的API服务。请您放心购买,感谢您的信赖!

商品评分

3.5/10

响应时间(近7天)

-

SLA(近一月)

100%
免费开通

按使用量计费查看价格

(在线时间:9:30-18:30)
4009030002 转13874
提交工单

POST

接口信息

https://swapface-api.segapi.com/swapface

POST

JSON

API 简单身份认证调用方法(APPCODE)API 签名认证调用方法(AppKey & AppSecret)

AppKey & AppCode

接口参数

请求参数(Header)

字段名称
必填
字段详情
无参数

请求参数(Query)

字段名称
必填
字段详情
无参数

请求参数(Body)

字段名称
必填
字段详情
无参数
云市场服务保障
*请勿线下交易!90%的欺诈、纠纷、资金盗取均由线下交易导致。

商品介绍

产品亮点

生成的写真的脸型与用户完全一致,人脸相似度在96%以上,超越普通的GAN换脸技术。写真的面部美感与模板图接近,真正达到AI写真既像又美的要求。

产品说明

产品功能

根据客户发送的写真模板图和用户照片,生成制作后的写真照片。

可提供的服务

我们提供服务端接口调用API,客户仅需按我们的接入文档实现相关调用代码即可。

调用说明

这是一个异步接口,调用后,不会直接返回制作后的结果图,而是通过异步通知的形态,将结果发回给调用者。
调用此接口需要进行签名等操作,以确保调用者的身份和数据安全,签名方式,可以参考阿里云文档关于签名部分

接口说明

1、发起AI写真任务提交接口

https://swapface-api.segapi.com/swapface

参数形式:JSON,比如:

{

"source_url": "https://user/photo/url",

"target_url": "https://target/template/photo/url",

"notify_url": "https://the/result/notify/url",

"timeout": 180

}

参数说明

source_url:字符串,必填,待制作的用户图片的url,必须是一个有效的图片的url,图片格式为jpg或者png,建议图片尺寸为640x640到2500x2500个像素之间。要求图中只包含一张人脸,且人脸清晰、完整,占比不太小,脸部没有大的角度,正脸效果最佳。

target_url:字符串,必填,模板图片的url,必须是一个有效的图片的url,图片格式为jpg或者png,建议图片尺寸为800x800到2000x2000个像素之间。要求图中只包含一张人脸,且人脸清晰、完整,占比不太小,脸部没有大的角度,正脸效果最佳。

notify_url:字符串,必填,结果通知接口url。由于本接口是一个异步接口,也就是说本接口调用后,并不会直接返回制作后的结果图,而是在任务执行后,通过异步的方式通知到调用者。所以调用者需要实现一个接受任务通知的异步接口,并将接口的地址放入此参数中。

timeout: 数字,选填,调用者预期的任务超时时间,单位为秒。但此参数不给定时,默认超时时间为7200秒,当给了超时时间,到达超时时间后,本任务就不再执行。任务超时后,本接口服务将会通过notify_url参数给出的接口地址,将超时错误发送给调用者。所以调用者无需自己维护一个超时队列。

返回数据

当本接口调用成功时,返回json格式:
{
  "status": 0,
  “errmsg”: “SUCCESSFULLY”, 
  “error”: “”,
  "data": {
    “job_id”: "本次任务的id,需要保存起来,用于对应后面的结果异步通知"
  }
}
说明:调用成功的标识为status字段的值为0,errmsg和error字段此时可以忽略不用管,
job_id需要保存好,在后面结果异步通知中会使用到

 

当本接口调用不成功时,返回json格式:
{
  "status": -310001,
  “error”: “InvalidArguments”,
  “errmsg”: “参数错误”, 
}
说明:调用失败时,status返回非0指,为错误码,error为错误名称,与status错误码对应,errmsg为错误描述。

 

2、任务结果异步通知

当换脸任务完成,或者发生错误时,需要将执行结果通过上一个接口设置的notify_url参数,通知到调用者,调用者接到通知后,需要返回http response status code为200,且body中为字符串“successfully”,表示调用者已经正确处理通知。如果返回的response的status code不为200,或者body中的字符串不为“successfully”,则表示通知失败;

通知失败的处理:如果通知失败,接口服务会在一定时后尝试重发通知,一共会重发10次通知,直到成功为止,如果重发10次后,仍然无法获取到成功响应,则会停止发送通知,这个任务就可能就会陷入丢失状态;

通知的数据格式如下:

当换脸操作成功时,通知的json格式:
{
  “job_id”: “换脸任务提交接口返回的job_id”,
  "status": 0,
  "data": {
    “result_url”: ["https://结果图片url,有效期为24小时,收到通知后,需要尽快下载到本地"]
  }
}
说明:调用成功的标识为status字段的值为0,结果图片在data.result_url字段中,job_id为提交任务时,由接口服务返回的任务id;result_url参数返回的是一个数组,里面包含了所有结果图片的url,但当前版本有且仅有一个元素(即只返回一张结果图片)

 

当换脸操作失败时,通知的json格式:
{
  “job_id”: “换脸任务提交接口返回的job_id”,
  "status": -22222,
  “error”: "",
  "data": {}
}
说明:换脸失败时候,status为非0值,error为错误名称,data字段不存在,或者为空

 

3、任务状态和结果查询接口

https://swapface-api.segapi.com/query

参数形式:JSON,比如:

{

    "job_id": "the_job_id_xxxxxx"

}

参数说明

job_id: 待查询的任务的id,由任务提交接口返回

返回数据

当本接口调用不成功时,返回json格式:
{
  "status": -310001,
  “error”: “InvalidArguments”,
  “errmsg”: “参数错误”, 
}
说明:调用失败时,status返回非0指,为错误码,error为错误名称,与status错误码对应,errmsg为错误描述。

 

当本接口调用成功时,有可能返回三种不同的数据:

任务完成,并生成结果图片时:

{

    "status": 0,

   "data": {

      "job_status": "finish",

     "result_url": ["https://结果图片url,保存时间为24小时"]

   }

}

 

任务失败,返回错误信息:

{

    "status": 0,

   "data": {

      "job_status": "fail",

     "reason": "错误原因",

     "code": 错误码,整形

   }

}

 

任务尚未完成:

{

    "status": 0,

   "data": {

      "job_status": "running"

   }

}

说明:

job_status可能有以下几种类型:

    "finish": 任务完成,且成功;

    "fail": 任务执行失败

    "running": 任务执行中

    "pending": 任务等待执行中

    "preparing": 任务准备执行中

result_url:返回的是一个数组,里面包含了所有结果图片的url,但当前版本有且仅有一个元素(即只产生一张结果图片)

 

产品参数

交付方式API
开票主体北京玩星汇聚科技有限公司
所属类目AI应用与OCR
上架日期2024-03-11

产品截图

https://photogallery.oss-cn-hangzhou.aliyuncs.com/photo/1372101300429605/undefineda811050877d845428959258f539daa0b.jpg

售后支持范围

服务范围:AI写真生成接口; 时间范围:不限; 业务范围:AI写真生成服务; 费用范围:按次计费,总量不设限;
本页面内容由服务商提供

商品价格(此处价格仅供参考,实际价格以选配后的价格为准)

计费项名称规格有效时间价格(元)
基础定价30次1月2.5
基础定价1000次1年300
基础定价10000次2年2500
基础定价50000次3年10000
基础定价100000次3年15000

使用指南

立即下载

客户案例

微信小程序:形象宝,超过百万用户,深受用户欢迎。

服务商

北京玩星汇聚科技有限公司

高精度自动抠图;智能证件照制作;证件照合规检测;
服务商星级:
  • 数据与API
客服在线:9:30-18:30
旺旺:旺旺logo技术支持2旺旺:旺旺logo爱分割商务旺旺:旺旺logo技术支持1

入住时间:2018-07-19

所在地区:110000 110100

入驻集市:数据市场

可开发票类型:增值税专用发票

查看工商登记信息

问题处理:

店铺交易情况

商家商品数量:15近180天成交订单量:839近180天退单率:0.12%

店铺评分状态

  • 评价数量:1594条
  • 综合总分:5分
  • 完成质量:5分
  • 工作速度:5分
  • 服务态度:5分

综合总分5分的分布

  • 0.00%
  • 0.00%
  • 0.00%
  • 0.00%
  • 0.00%

用户评论

综合评分
--

暂无评价