风格转换

Action ApplyReferenceStyle

简介

此接口将基于参考图的风格重新绘制原始图片，以达到转换风格的效果。

请求

参数名	类型	描述信息	必填
Action	`String`	对应的 API 指令名称	✓
PublicKey	`String`	用户公钥，可从 PICPIK用户中心 (opens in a new tab) 获取	✓
Signature	`String`	根据公钥及 API 指令生成的用户签名，参见签名算法	✓
request_uuid	`String`	请求uuid，采用uuid生成方式随机生成，可用于管理您业务和客户的请求

参数名	类型	描述信息	必填
MainModel	`Model`	主模型	✓
SubModelList	`[]Model`	子模型列表，包含LoRA、Embedding和HyperNetwork
PositivePrompts	`[]String`	希望在画面中出现的内容描述
NegativePrompts	`[]String`	不希望在画面中出现的内容描述
TranslatePrompts	`Bool`	是否将内容描述翻译成英文，支持的语言列表见此处。默认值：true
Seed	`Int`	种子编号（-1~2147483647），-1代表随机种子，默认值：-1
Width	`Int`	图片宽度（64~2560），默认值：1024
Height	`Int`	图片高度（64~2560），默认值：1024
BatchSize	`Int`	批量生图的数量（1~16），默认值：1
UseMainModelVAE	`Bool`	是否使用主模型自带的编解码器，默认值：false

参数名	类型	描述信息	必填
RawImageIndex	`Int`	原始图片在ImageList中的索引编号，从0开始	✓
StyleImageIndex	`Int`	风格参考图片在ImageList中的索引编号，从0开始	✓
StyleReferStrength	`Float`	风格参考图的参考强度(0~1)。步长：0.01，默认值：0.5
ImageList	`[]Base64`	Base64编码的图片列表

复杂数据类型说明

`Model`

字段名	类型	描述信息	必填
Name	`String`	模型名称
ModelCode	`String`	模型编码	✓
IsOfficial	`Bool`	是否为官方模型
TriggerWordList	`[]String`	触发词列表（仅模型为lora时生效）
InferenceParams	`InferenceParams`	推理用的参数

请求示例

{
    "Action": "ApplyReferenceStyle",
    "MainModel": {
      	"ModelCode"  : "PICPIK Interior Design"
    },
    "PositivePrompts": ["a apple"],
    "NegativePrompts": [],
    "TranslatePrompts": true,
    "RawImageIndex": 0,
    "StyleImageIndex": 1,
    "StyleReferStrength": 0.5,
    "Seed": -1,
    "Width": 1024,
    "Height": 1024,
    "BatchSize": 1,
    "UseMainModelVAE": true,
    "ImageList": ["imagebase64","imagebase64"]
}

响应

字段名	类型	描述信息	必填
RetCode	`Int`	返回状态码，为 0 则为成功返回，非 0 为失败	✓
Action	`String`	操作指令名称	✓
Message	`String`	返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息
request_uuid	`String`	返回请求时填写的uuid

参数名	类型	描述信息	必填
TaskUID	`String`	任务UID，用于查询任务详情与获取结果	✓

响应示例

{
	"Action": "ApplyReferenceStyle",
	"RetCode": 0,
	"Message": "",
	"request_uuid": "8482d350-04f9-421b-817b-1d98b3a4dcfa",
	"TaskUID": "cktlm6lrh4xxx8ng9nf0"
}

假模转真人（人台图）图案提取并重绘