生成图像

POST

/recraft/v1/images/generations

根据文本描述生成图像

请求参数

Body 参数application/json

prompt

string

必需

期望生成图像的文本描述

<= 1000 字符

enum<integer>

需要生成的图像数量

可选

枚举值:

默认值:

style_id

string <uuid>

可选

使用已上传的样式ID(与style参数互斥)

style

enum<string>

可选

生成图像的风格(与style_id参数互斥)

枚举值:

realistic_imagedigital_illustrationvector_illustrationicon

默认值:

realistic_image

substyle

string

选择风格的子风格

可选

model

enum<string>

使用的模型

可选

枚举值:

recraftv3recraft20b

默认值:

recraftv3

response_format

enum<string>

返回的图像格式

可选

枚举值:

urlb64_json

默认值:

url

size

enum<string>

可选

生成图像的尺寸(宽x高)

枚举值:

1024x10241365x10241024x13651536x10241024x15361820x10241024x18201024x20482048x10241434x10241024x14341024x12801280x10241024x17071707x1024

默认值:

1024x1024

controls

object

可选

colors

array [object {1}]

首选颜色数组

可选

background_color

string

期望的背景颜色

可选

示例

{
    "prompt": "string",
    "n": 1,
    "style_id": "42816bda-d9c2-4157-9d9c-8806b666d646",
    "style": "realistic_image",
    "substyle": "string",
    "model": "recraftv3",
    "response_format": "url",
    "size": "1024x1024",
    "controls": {
        "colors": [
            {
                "rgb": [
                    0,
                    0,
                    0
                ]
            }
        ],
        "background_color": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/recraft/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "n": 1,
    "style_id": "42816bda-d9c2-4157-9d9c-8806b666d646",
    "style": "realistic_image",
    "substyle": "string",
    "model": "recraftv3",
    "response_format": "url",
    "size": "1024x1024",
    "controls": {
        "colors": [
            {
                "rgb": [
                    0,
                    0,
                    0
                ]
            }
        ],
        "background_color": "string"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

修改于 2025-06-09 15:54:11

创建样式

图像矢量化