弃用
API参考(旧版)
图片脸部替换

图片脸部替换

Action GenerateSwapFace

简介

⚠️

该接口已过时,不再维护。

此接口用于图片脸部替换

请求

参数名类型描述信息必填
ActionString对应的 API 指令名称,当前 API 为 GenerateSwapFace
PublicKeyString用户公钥,可从 用户中心 (opens in a new tab) 获取
SignatureString根据公钥及 API 指令生成的用户签名,参见 签名算法
request_uuidString请求uuid,采用uuid生成方式随机生成
ModelTypeString模型类型,参考值:combined_modelcustom_model。使用PICPIK提供的官方模型需填写combined_model,使用自训练或上传的模型需填写custom_model
MainModelIdInt主模型ID若ModelType为combined_model,则填写SystemPreInstallModels的Id,否则填写则填写SelfMainModels的Id
StepsInt迭代步数1~150
ReferenceImageString参考图Base64
FaceImageString脸部图像Base64
FaceIndexInt需要更换第几张脸,从1开始
UseCustomMainModelVaeBool是否使用主模型VAE,true为使用主模型自带VAE,默认false

请求示例

{
    "Action":"GenerateSwapFace",
    "PublicKey":"ALLak9M4cNdHXKOJAJJ4k8Hh1hZS2EgJF1D0FlPwfl",
    "request_uuid":"b91fcfbe-bb35-47ce-a168-bd6252c75270",
    "Signature":"4b0e2666680e03641c1ad2eb3863d2089e67995b",
    "ModelType":"combined_model",
    "MainModelId":1,
    "Steps":20,
    "ReferenceImage":"data:image/jpeg;base64,xxx",
    "FaceImage":"data:image/jpeg;base64,xxx",
    "FaceIndex":1
}

响应

参数名类型描述信息必填
RetCodeInt返回状态码,为 0 则为成功返回,非 0 为失败
ActionString操作指令名称
MessageString返回错误消息,当 RetCode 非 0 时提供详细的描述信息
TaskUIDString任务UID,用于查询任务详情与获取结果

响应示例

{
    "Action":"",
    "RetCode":0,
    "Message":"",
    "TaskUID":"cjr997tleg738lelk3n0"
}