Img Open

sd 文生图-v2

POST

/AIGCImgOpenServ/saas/sd/v2/text2image

img

文生图，根据prompt提示词生成图

请求参数

Header 参数

X-Request-req-accessKeyId

string

必需

示例值:

accessKeyId

X-Request-req-accessKeySecret

string

必需

示例值:

accessKeySecret

Body 参数application/json

n_iter

integer

生成的批次

可选

batch_size

integer

每批次生成数量

必需

最终生图数量=n_iter*batch_size

steps

integer

迭代步数

可选

hr_scale

integer

高清修复倍数

可选

negative_prompt

string

负向描述词

可选

建议词：nsfw, lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality, normal quality, artifacts, signature, watermark, username, blurry, missing arms, long neck, humpbacked, bad feet

denoising_strength

number

重绘幅度

可选

降噪强度，取值范围是0-1，默认设置0.75。取值越大，说明图片变化越大，0表示图片几乎不变，1表示可能严重偏离原图。一般将该参数设置在0.6~0.8范围；

width

integer

图片宽度

可选

[128,1024] 且为8的倍数

height

integer

图片高度

可选

[128,1024] 且为8的倍数

hr_upscaler

string

要使用的放大器

可选

高清修复模式下要使用的放大器

alwayson_scripts

object

外部传入参数

必需

override_settings

object

外部传入参数

可选

sd_model_checkpoint

string

模型编码，需要带着

必需

参考模型列表中的模型编码

sd_vae

string

变分自动编码器

可选

提升出图效果

id_task

string

任务id

必需

output_image_format

string

输出图片格式

可选

输出图片格式，默认无需传参，输出图片格式jpg，可支持输入png

ADetailer

object

adetailer插件

可选

prompt

string

正向描述词

必需

绘画的文本描述（支持中文和英文描述）,使用lora,可以查询lora列表，参考sdLoraFileSimplifyName

enable_hr

boolean

高清修复

可选

默认false

seed

string

随机种子

可选

默认-1就是随机

restore_faces

boolean

脸部修复

可选

恢复面部缺陷应用了额外模型，该模型可以恢复面部缺陷，默认为 false

cfg_scale

number

提示词引导系数

可选

CFG AI生图与你给的提示词的相关度，数值越高越会按照你说的内容下去生图。控制模型和prompt的匹配程度，1.忽视prompt， 3.更有创意，7，在prompt和freedom中取得平衡，15，遵守prompt，30，严格按照prompt

sampler_index

string

采样方式

可选

可选["Euler a","Euler","LMS","Heun","DPM2","DPM2 a","DPM++ 2S a","DPM++ 2M","DPM++ SDE","DPM fast","DPM adaptive","LMS Karras","DPM2 Karras","DPM2 a Karras","DPM++ 2S a Karras","DPM++ SDE Karras","DPM++ 2M Karras",]

hr_second_pass_steps

integer

高清修复的后面步骤

可选

hr_resize_x

integer

高清修复后的高度

可选

[128,2048] 且为8的倍数

hr_resize_y

integer

高清修复后的宽度

可选

[128,2048] 且为8的倍数

callbackUrl

string

回调地址

可选

用于服务端回传绘图结果有部分接口是异步接口 , 请查看备注收到响应的json字符串 code = 200 我们才会标记为请求成功如 {"code":"200"} 阶梯间隔重试 3 、5、15、30、60 、600、3600秒最多重试10次

示例

{
    "prompt": "{best quality}, {{masterpiece}}, {highres}, original, extremely detailed,incredibly_absurdres,intricate detail,(detailed face),(face:1.2),1girl , kneeling down, from below , crying, sitting, ghost",
    "n_iter": 1,
    "steps": 25,
    "seed":"1221212",
    "restore_faces": false,
    "enable_hr": false,
    "hr_scale": 2,
    "width": 768,
    "height": 768,
    "negative_prompt": "(nsfw:1.5),(nude:1.3), (child Pornography:1.2),molestation,incest,rape,about to be raped,(sex:1.3),uncensored,EasyNegative,(worst quality, low quality:1.4), (((distorted hands))),((disfigured)), ((bad art)), ((deformed)),((extra limbs)),((b&w)), (((duplicate))), ((morbid)), ((mutilated)),poorly drawn face, out of frame, mutation, mutated, (text), signature, monster,watermark,extra fingers,fewer fingers, Wrong hands,wrong fingers,fingers crossed,styled fingers,fingers missed,missed fingers,cheese fingers, chocolate fingers,fingers on fingers,closed fist, fighting fist,fist ,hands with fist,many fists,only hands with wrong fists,fingers crossed,\r\n,",
    "cfg_scale": 27,
    "sampler_index":"DPM++ 2M Karras",
    "hr_second_pass_steps":20,
    "hr_resize_x":1024,
    "hr_resize_y":1024,
    "denoising_strength": 0.55,
    "callbackUrl":"http://127.0.0.1:8087/image/api/callback/sdweb",
    "alwayson_scripts": {
        "sd_model_checkpoint": "revAnimated_v122_7371.safetensors",
        "id_task": "pro1686666",
        "sd_vae": "vae-ft-mse-840000-ema-pruned.ckpt",
        "override_settings": {
            "CLIP_stop_at_last_layers": 2
        },
        "ADetailer": {
            "args": [
                {
                    "ad_model": "None",
                    "ad_prompt": "",
                    "ad_negative_prompt": "",
                    "ad_confidence": 0.3,
                    "ad_mask_min_ratio": 0.0,
                    "ad_mask_max_ratio": 1.0,
                    "ad_dilate_erode": 32,
                    "ad_x_offset": 0,
                    "ad_y_offset": 0,
                    "ad_mask_merge_invert": "None",
                    "ad_mask_blur": 4,
                    "ad_denoising_strength": 0.4,
                    "ad_inpaint_only_masked": true,
                    "ad_inpaint_only_masked_padding": 0,
                    "ad_use_inpaint_width_height": false,
                    "ad_inpaint_width": 512,
                    "ad_inpaint_height": 512,
                    "ad_use_steps": true,
                    "ad_steps": 28,
                    "ad_use_cfg_scale": false,
                    "ad_cfg_scale": 7.0,
                    "ad_use_sampler": false,
                    "ad_sampler": "DPM++ 2M Karras",
                    "ad_use_noise_multiplier": false,
                    "ad_noise_multiplier": 1.0,
                    "ad_restore_face": false,
                    "ad_controlnet_model": "None",
                    "ad_controlnet_module": "None",
                    "ad_controlnet_weight": 1.0,
                    "ad_controlnet_guidance_start": 0.0,
                    "ad_controlnet_guidance_end": 1.0
                }
            ]
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zhiqite.com/AIGCImgOpenServ/saas/sd/v2/text2image' \
--header 'X-Request-req-accessKeyId: accessKeyId' \
--header 'X-Request-req-accessKeySecret: accessKeySecret' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "{best quality}, {{masterpiece}}, {highres}, original, extremely detailed,incredibly_absurdres,intricate detail,(detailed face),(face:1.2),1girl , kneeling down, from below , crying, sitting, ghost",
    "n_iter": 1,
    "steps": 25,
    "seed":"1221212",
    "restore_faces": false,
    "enable_hr": false,
    "hr_scale": 2,
    "width": 768,
    "height": 768,
    "negative_prompt": "(nsfw:1.5),(nude:1.3), (child Pornography:1.2),molestation,incest,rape,about to be raped,(sex:1.3),uncensored,EasyNegative,(worst quality, low quality:1.4), (((distorted hands))),((disfigured)), ((bad art)), ((deformed)),((extra limbs)),((b&w)), (((duplicate))), ((morbid)), ((mutilated)),poorly drawn face, out of frame, mutation, mutated, (text), signature, monster,watermark,extra fingers,fewer fingers, Wrong hands,wrong fingers,fingers crossed,styled fingers,fingers missed,missed fingers,cheese fingers, chocolate fingers,fingers on fingers,closed fist, fighting fist,fist ,hands with fist,many fists,only hands with wrong fists,fingers crossed,\r\n,",
    "cfg_scale": 27,
    "sampler_index":"DPM++ 2M Karras",
    "hr_second_pass_steps":20,
    "hr_resize_x":1024,
    "hr_resize_y":1024,
    "denoising_strength": 0.55,
    "callbackUrl":"http://127.0.0.1:8087/image/api/callback/sdweb",
    "alwayson_scripts": {
        "sd_model_checkpoint": "revAnimated_v122_7371.safetensors",
        "id_task": "pro1686666",
        "sd_vae": "vae-ft-mse-840000-ema-pruned.ckpt",
        "override_settings": {
            "CLIP_stop_at_last_layers": 2
        },
        "ADetailer": {
            "args": [
                {
                    "ad_model": "None",
                    "ad_prompt": "",
                    "ad_negative_prompt": "",
                    "ad_confidence": 0.3,
                    "ad_mask_min_ratio": 0.0,
                    "ad_mask_max_ratio": 1.0,
                    "ad_dilate_erode": 32,
                    "ad_x_offset": 0,
                    "ad_y_offset": 0,
                    "ad_mask_merge_invert": "None",
                    "ad_mask_blur": 4,
                    "ad_denoising_strength": 0.4,
                    "ad_inpaint_only_masked": true,
                    "ad_inpaint_only_masked_padding": 0,
                    "ad_use_inpaint_width_height": false,
                    "ad_inpaint_width": 512,
                    "ad_inpaint_height": 512,
                    "ad_use_steps": true,
                    "ad_steps": 28,
                    "ad_use_cfg_scale": false,
                    "ad_cfg_scale": 7.0,
                    "ad_use_sampler": false,
                    "ad_sampler": "DPM++ 2M Karras",
                    "ad_use_noise_multiplier": false,
                    "ad_noise_multiplier": 1.0,
                    "ad_restore_face": false,
                    "ad_controlnet_model": "None",
                    "ad_controlnet_module": "None",
                    "ad_controlnet_weight": 1.0,
                    "ad_controlnet_guidance_start": 0.0,
                    "ad_controlnet_guidance_end": 1.0
                }
            ]
        }
    }
}'

返回响应

🟢200成功

application/json

Body

code

string

返回状态码

必需

成功=200 失败=400

msg

string

返回状态信息

必需

data

object

必需

task_id

string

业务id

必需

此task_id和请求里的id_task是一个值

示例

{
    "code": "200",
    "msg": "success",
    "data": {
        "task_id": "pro1686666"
    }
}

修改于 2024-10-18 01:40:57

CV任务状态码信息附录

sd 文生图-v3