文生图 - AIGC2D

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

main_model_id

integer

可选

模型ID，通过获取SD模型接口获取ID

batch_size

integer

可选

生成数量1~16，默认1

默认值:

1

steps

integer

可选

迭代步数1~150，默认20

默认值:

20

cfg_scale

number <float64>

可选

提示词指导程度0~30

默认值:

7.5

seed

integer

随机数种子

可选

默认值:

-1

sampler

enum<string> <string>

采样器

必需

枚举值:

Euler aEulerLMSHeunDPM2DPM2 aDPM++ 2S aDPM++ 2MDPM++ SDEDPM++ 2M SDEDPM fastDPM adaptiveLMS KarrasDPM2 KarrasDPM2 a KarrasDPM++ 2S a KarrasDPM++ 2M KarrasDPM++ SDE KarrasDPM++ 2M SDE KarrasDDIMPLMSUniPC

默认值:

Euler

width

integer

可选

图片生成宽度，最大值: 1440，最小值: 16

height

integer

可选

图片生成高度，最大值: 1440，最小值: 16

clip_skip

integer

ClipSkip

可选

默认值:

1

translate_prompt

boolean

可选

是否将提示词翻译成英文

默认值:

false

positive_prompts

array[string <string>]

正面提示词

可选

negative_prompts

array[string <string>]

反面提示词

可选

enable_control_net

boolean

可选

是否开启controlNet

control_net_params

array [object {12}]

可选

ControlNet参数列表(最多三个)，通过ControlNet模型接口获取ID信息

control_net_img

string <string>

可选

ControlNet图片base64

control_pre_set_id

string <string>

可选

ControlNet预设参数Id，0:自定义，1:简笔涂鸦，2:人物姿势，3:动漫线稿，4: 空间线稿

control_weight

number <float64>

可选

ControlNet权重 0~2

model_id

integer

可选

ControlNet模型Id

pre_processor_id

integer

可选

ControlNet预处理器Id

starting_control_step

integer

可选

ControlNet开始介入步数

ending_control_step

integer

可选

ControlNet结束介入步数

control_mode

string <string>

可选

控制模式，参考值: Balanced、MyPromptIsMoreImportant、ControlNetIsMoreImportant

resize_mode

string <string>

可选

缩放模式，参考值：JustResize、CropAndResize、ResizeAndFill

pre_processor_resolution

integer

可选

PreProcessorResolution

param_1_value

number <float64>

参数1

可选

param_2_value

number <float64>

参数2

可选

use_custom_main_model_vae

boolean

可选

是否使用主模型VAE，true为使用主模型自带VAE，默认false

示例

{
  "sampler": "Euler",
  "width": 512,
  "clip_skip": 1,
  "main_model_id": 1,
  "use_custom_main_model_vae": false,
  "batch_size": 1,
  "enable_control_net": false,
  "negative_prompts": [],
  "translate_prompt": true,
  "seed": -1,
  "cfg_scale": 7.5,
  "height": 512,
  "positive_prompts": [
    "a apple"
  ],
  "steps": 20
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.aigc2d.com/sd/txt2img' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sampler": "Euler",
    "width": 512,
    "clip_skip": 1,
    "main_model_id": 1,
    "use_custom_main_model_vae": false,
    "batch_size": 1,
    "enable_control_net": false,
    "negative_prompts": [],
    "translate_prompt": true,
    "seed": -1,
    "cfg_scale": 7.5,
    "height": 512,
    "positive_prompts": [
        "a apple"
    ],
    "steps": 20
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

task_id

integer

任务ID

必需

message

string

必需

data

null

必需

示例

{
  "code": 0,
  "task_id": 474195782291461,
  "message": "success",
  "data": null
}

🟠400请求有误