API
API参考
图案迁移

图案迁移

Action ApplyReferencePattern

简介

此接口将基于参考图中的图案重新绘制原始图片的蒙版区域，以达到应用图案的效果。

请求

参数名类型描述信息必填
ActionString对应的 API 指令名称✓
PublicKeyString用户公钥，可从 PICPIK用户中心 (opens in a new tab) 获取✓
SignatureString根据公钥及 API 指令生成的用户签名，参见 签名算法✓
request_uuidString请求uuid，采用uuid生成方式随机生成，可用于管理您业务和客户的请求
参数名类型描述信息必填
MainModelModel主模型✓
SubModelList[]Model子模型列表，包含LoRA、Embedding和HyperNetwork
PositivePrompts[]String希望在画面中出现的内容描述
NegativePrompts[]String不希望在画面中出现的内容描述
TranslatePromptsBool是否将内容描述翻译成英文，支持的语言列表见此处。默认值：true
SeedInt种子编号（-1~2147483647），-1代表随机种子，默认值：-1
WidthInt图片宽度（64~2560），默认值：1024
HeightInt图片高度（64~2560），默认值：1024
BatchSizeInt批量生图的数量（1~16），默认值：1
UseMainModelVAEBool是否使用主模型自带的编解码器，默认值：false
参数名类型描述信息必填
RawImageIndexInt原始图片在ImageAndMaskList中的索引编号，从0开始✓
MaskIndexInt蒙版在ImageAndMaskList中的索引编号，从0开始✓
PatternImageIndexInt风格参考图片在ImageAndMaskList中的索引编号，从0开始✓
PatternReferStrengthFloat风格参考图的参考强度(0~1)。步长：0.01，默认值：0.75
ChaoticModeBool混沌模式。如果生成效果不佳，可尝试开启。默认值：false
ColorCorrectionBool色彩校正。如果颜色偏差大，可尝试开启校正，但混沌模式下无效。默认值：false
ImageAndMaskList[]Base64Base64编码的图片和蒙版列表

复杂数据类型说明

Model

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

请求示例

{
    "Action": "ApplyReferencePattern",
    "MainModel": {
      	"ModelCode"  : "PICPIK General"
    },
    "PositivePrompts": ["写实照片", "现实的", "工作室灯光", "静物摄影"],
    "RawImageIndex": 0,
    "MaskIndex": 1,
    "PatternImageIndex": 2,
    "ChaoticMode": false,
    "ColorCorrection": false,
    "ImageAndMaskList": ["imagebase64","imagebase64","imagebase64"]
}

响应

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

响应示例

{
	"Action": "ApplyReferencePattern",
	"RetCode": 0,
	"Message": "",
	"request_uuid": "8482d350-04f9-421b-817b-1d98b3a4dcfa",
	"TaskUID": "cktlm6lrh4xxx8ng9nf0"
}
图案提取并重绘高清缩放