API Reference (Legacy)
Text to Image

Text to Image

Action GenerateTxt2Img



This interface is no longer maintained.

This interface is used to generate images using text.


Parameter NameTypeDescriptionRequired
ActionStringThe corresponding API command name, the current API is GenerateTxt2Img
PublicKeyStringUser's public key, which can be obtained from User Center (opens in a new tab)
SignatureStringUser signature generated based on public key and API command, see Signature
request_uuidStringRequest UUID, randomly generated using UUID generation method
ModelTypeStringModel type, reference value: combined_model, custom_model. To use the official model provided by PICPIK, you need to fill in combined_model, and to use a self-trained or uploaded model, you need to fill in custom_model
MainModelIdIntMain model ID. If ModelType is combined_model, fill in the Id of SystemPreInstallModels; otherwise, fill in the Id of SelfMainModels
SubModelIds[]intSubmodel list, do not fill in if ModelType is combined_model
SubModelParams[]SubModelParamSubmodel parameters. If SubModelIds is used, the weight of the submodel can be controlled through this parameter.
BatchSizeIntBatch image size 1~16
StepsIntIteration steps 1~150
CfgScaleFloatPrompt word guidance level 0~30
SeedIntRandom number seed
SamplerStringSampler ,Reference Support Samplers
WidthIntImage generation width, max: 1440, min: 16
HeightIntImage generation height, max: 1440, min: 16
TranslatePromptBoolWhether to translate the prompt word into English
PositivePrompts[]StringPositive prompts
NegativePrompts[]StringNegative prompts
EnableControlNetBoolWhether to enable controlNet
ControlNetParams[]ControlNetParam ControlNet parameters list (max length:3)
UseCustomMainModelVaeBoolUsing main model VAE ,true means use main model VAE,default false


Parameter NameTypeDescriptionRequired
ControlNetImgStringControlNet image base64
ControlPreSetIdStringControlNet Default parameter ID, 0: customized, 1: Graffiti and Sketch, 2: Figure's Pose, 3: Anime Line Drawing, 4: Spatial Line Drawing
ControlWeightFloatControlNet weight 0~2
ModelIdIntControlNet model ID
PreProcessorIdIntControlNet preprocessor ID
StartingControlStepFloatStarting control step of ControlNet
EndingControlStepFloatEnding control step of ControlNet
ControlModeStringControl mode, reference value: Balanced、MyPromptIsMoreImportant、ControlNetIsMoreImportant
ResizeModeStringResize mode, reference value: JustResize、CropAndResize、ResizeAndFill
Param1ValueFloatParameter 1
Param2ValueFloatParameter 2

Note: If ControlPreSetId is not 0, you only need to fill in the ControlNetImg and ControlWeight parameter. Otherwise, all parameters need to be filled in. Parameter referenceControlNet Model List


SubModelIdIntSub model Id
ControlWeightFloatSub model control weight(Lora weight)

Request example

	"Action": "GenerateTxt2Img",
	"PublicKey": "ALLak9M4cNdHXKOJAJJ4k8Hh1hZS2EgJF1D0FlPwfl",
	"Signature": "10e99193615e2c363f15f7339b3dac0c91a9272a",
	"request_uuid": "fc30beb9-89e3-4f38-9c90-82201fe91d32",
	"ModelType": "combined_model",
	"MainModelId": 1,
	"BatchSize": 1,
	"Steps": 20,
	"CfgScale": 7.5,
	"Seed": -1,
	"Sampler": "Euler",
	"ClipSkip": 1,
	"Width": 512,
	"Height": 512,
        "an apple"
	"TranslatePrompt": true

Request example with ControlNet

        "a apple"
            //ControlNet using preset parameters
            //ControlNet using custom parameters, ControlPreSetId need to be set 0


Parameter NameTypeDescriptionRequired
RetCodeIntReturn status code. If 0, it indicates a successful return; if non-zero, it indicates a failure
ActionStringOperation command name
MessageStringReturn error message. When RetCode is non-zero, it provides detailed description information
TaskUIDStringTask UID, used to query task details and get results

Response Example


Support Samplers

Sampler Name
Euler a
DPM2 a
DPM++ 2S a
DPM++ 2M
DPM fast
DPM adaptive
LMS Karras
DPM2 Karras
DPM2 a Karras
DPM++ 2S a Karras
DPM++ 2M Karras
DPM++ SDE Karras
DPM++ 2M SDE Karras