Generate Image

Request

Body Params application/json

prompt

string

required

A text description of the desired image(s). The maximum length is 1000 bytes

text_layout

array[string]

optional

style_id

string

optional

Use a previously uploaded style as a reference

style

string

optional

The style of the generated images
default is realistic_image

substyle

string

optional

The format in which the generated images are returned. Must be one of url or b64_json
default is url

response_format

string

optional

size

string

optional

The size of the generated images in WxH format, supported values are published below
default is 1024x1024

negative_prompt

string

optional

A text description of undesired elements on an image.

controls

object

optional

A set of custom parameters to tweak generation process

colors

string

optional

background_color

string

optional

Example

{
  "prompt": "red point siamese hourse",
  "style": "realistic_image",
  "size": "1280x1024",
  "n":5,
  "text_layout": [
            {
                "text": "Bogia",
                "bbox": [[0.3, 0.45], [0.6, 0.45], [0.6, 0.55], [0.3, 0.55]]
            },
            {
                "text": "AI",
                "bbox": [[0.62, 0.45], [0.70, 0.45], [0.70, 0.55], [0.62, 0.55]]
            }
        ]

}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/recraft/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "red point siamese hourse",
  "style": "realistic_image",
  "size": "1280x1024",
  "n":5,
  "text_layout": [
            {
                "text": "Bogia",
                "bbox": [[0.3, 0.45], [0.6, 0.45], [0.6, 0.55], [0.3, 0.55]]
            },
            {
                "text": "AI",
                "bbox": [[0.62, 0.45], [0.70, 0.45], [0.70, 0.55], [0.62, 0.55]]
            }
        ]

}'

Responses

🟢200Ok

application/json

Body

created

integer

required

data

array [object {1}]

required

url

string

required

usage

null

required

image

array[string]

required

metadata

object

required

credits

integer

required

height

integer

required

images

array [object {5}]

required

random_seed

integer

required

request_id

string

required

transform_model

string

required

width

integer

required

timings

null

required

Example

{
    "created": 1750392919,
    "data": [
        {
            "url": "https://s3.ffire.cc/cdn/20250620/5AiJwjRacjtUgjQFNCwJDR"
        },
        {
            "url": "https://s3.ffire.cc/cdn/20250620/dnJZmDiCegRGYucMYU3dhq"
        }
    ],
    "usage": null,
    "image": [
        "https://s3.ffire.cc/cdn/20250620/5AiJwjRacjtUgjQFNCwJDR",
        "https://s3.ffire.cc/cdn/20250620/dnJZmDiCegRGYucMYU3dhq"
    ],
    "metadata": {
        "credits": 2,
        "height": 1024,
        "images": [
            {
                "image_id": "309077fd-c10b-47d7-9018-153142003760",
                "image_invariants": {
                    "preset": "digital_illustration"
                },
                "text_layout": [
                    {
                        "bbox": [
                            [
                                0.3,
                                0.45
                            ],
                            [
                                0.6,
                                0.45
                            ],
                            [
                                0.6,
                                0.55
                            ],
                            [
                                0.3,
                                0.55
                            ]
                        ],
                        "text": "Vũ"
                    },
                    {
                        "bbox": [
                            [
                                0.62,
                                0.45
                            ],
                            [
                                0.7,
                                0.45
                            ],
                            [
                                0.7,
                                0.55
                            ],
                            [
                                0.62,
                                0.55
                            ]
                        ],
                        "text": "AI"
                    }
                ],
                "transparent": false,
                "vector_image": false
            },
            {
                "image_id": "2cb9cda4-fc7a-478b-b692-2acc4c2e1e1c",
                "image_invariants": {
                    "preset": "digital_illustration"
                },
                "text_layout": [
                    {
                        "bbox": [
                            [
                                0.3,
                                0.45
                            ],
                            [
                                0.6,
                                0.45
                            ],
                            [
                                0.6,
                                0.55
                            ],
                            [
                                0.3,
                                0.55
                            ]
                        ],
                        "text": "Vũ"
                    },
                    {
                        "bbox": [
                            [
                                0.62,
                                0.45
                            ],
                            [
                                0.7,
                                0.45
                            ],
                            [
                                0.7,
                                0.55
                            ],
                            [
                                0.62,
                                0.55
                            ]
                        ],
                        "text": "AI"
                    }
                ],
                "transparent": false,
                "vector_image": false
            }
        ],
        "random_seed": 2636873849,
        "request_id": "355ccb3a-1c9c-494b-8fa8-c6875fe07d34",
        "transform_model": "recraftv3",
        "width": 1365
    },
    "timings": null
}