豆包文生图

请求参数

Header 参数

Authorization

string

认证信息

必需

示例值:

Bearer {{api_key}}

Body 参数application/json

model

enum<string>

模型名称

必需

枚举值:

general_v2.1_L

prompt

string

必需

图片画面描述支持中文

示例值:

1+1

size

enum<string>

可选

图片大小不同模型尺寸不同

枚举值:

512x512512x384384x512512x341341x512512x288288x512

默认值:

1024x1024

示例值:

1024x1024

use_sr

boolean

可选

内置的超分功能，开启后可将上述宽高均乘以2返回，此参数打开后延迟会有增加\n如上述宽高均为512和512，此参数关闭出图 512*512 ，此参数打开出图1024 * 1024

默认值:

false

req_schedule_conf

enum<string>

可选

标准版：图文匹配度更好，结构表现更好\n美感版：美感更好，出图多样性更多

枚举值:

general_v20_9B_pegeneral_v20_9B_rephraser

默认值:

general_v20_9B_pe

scale

number

可选

影响文本描述的程度默认值: 3.5 范围:[1, 10]

>= 1<= 10

默认值:

3.5

add_logo

boolean

可选

是否添加水印。True为添加，False不添加。默认不添加

默认值:

false

position

enum<integer>

水印的位置

可选

枚举值:

0123

language

enum<integer>

水印的语言

可选

枚举值:

01

opacity

number

可选

印的不透明度取值范围0-1 1表示完全不透明，默认0.3

>= 0<= 1

默认值:

0.3

logo_text_content

string

明水印自定义内容

可选

示例

{
    "model": "general_v2.1_L",
    "prompt": "1+1",
    "size": "512x512",
    "use_sr": true,
    "req_schedule_conf": "general_v20_9B_rephraser",
    "scale": 3.5,
    "add_logo": true,
    "position": 1,
    "language": 0,
    "opacity": 0.3,
    "logo_text_content": "这是水印"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.mindcraft.com.cn/v1/images/generations' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "general_v2.1_L",
    "prompt": "1+1",
    "size": "512x512",
    "use_sr": true,
    "req_schedule_conf": "general_v20_9B_rephraser",
    "scale": 3.5,
    "add_logo": true,
    "position": 1,
    "language": 0,
    "opacity": 0.3,
    "logo_text_content": "这是水印"
}'

返回响应

🟢200成功

application/json

Body

id

string

必需

model

string

必需

usage

object

必需

prompt_cost

integer

必需

data

array [object {3}]

必需

file_url

string

可选

image_width

integer

可选

image_height

integer

可选

示例

成功示例异常示例违规请求

{
    "id": "615f4b3944e240a4b6e7cd013615154e",
    "model": "general_v2.1_L",
    "usage": {
        "prompt_cost": 200
    },
    "data": [
        {
            "file_url": "https://p3-aiop-sign.byteimg.com/tos-cn-i-vuqhorh59i/20250225113017A18659DDDD2F54776860-0~tplv-vuqhorh59i-image.image?rk3s=7f9e702d&x-expires=1740540630&x-signature=6wTBiENMzxN48BsAoCh3qYP6Zsg%3D",
            "image_width": 512,
            "image_height": 512
        }
    ]
}

豆包 文生图

使用 openai的py包 代码请求#

请求参数

示例代码

返回响应

使用 openai的py包代码请求