Recraft Generate Image - API Doc-CometAPI

Request

Header Params

Authorization

string

optional

Example:

Body Params application/json

prompt

string

required

n

integer

optional

1，2

Default:

1

style_id

string

optional

style

string

optional

Default:

realistic_image

substyle

string

optional

response_format

enum<string>

optional

Return the format of the generated image, either “url” or “b64_json”.

Allowed values:

urlb64_json

Default:

url

size

string

optional

Image size, e.g. “1024x1024”.

Default:

1024x1024

controls

object

optional

colors

string

optional

An array of 3 integer values in range of 0...255 defining RGB Color Model

background_color

string

optional

Example

{
    "prompt": "race car on a track",
    "style": "digital_illustration"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.cometapi.com/recraft/v1/images/generations' \
--header 'Authorization: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "race car on a track",
    "style": "digital_illustration"
}'

Responses

🟢200OK

application/json

success

Body

created

integer

required

Timestamp when the response was created

data

array [object {1}]

required

Array containing the main output data

url

string

optional

URL of the generated image file

usage

null

required

Information about API usage

image

array[string]

required

Array containing URLs of generated images

metadata

object

required

Contains metadata related to the generation process and results

credits

integer

required

height

integer

required

Height of the generated image

images

array [object {4}]

required

An array containing detailed information about each generated image

random_seed

integer

required

request_id

string

required

Unique identifier for this API request

transform_model

string

required

Specific model name or version used for image transformation or generation

width

integer

required

Width of the generated image

timings

null

required

Detailed information about request processing time

Example

{
  "created": 1747621667,
  "data": [
    {
      "url": "https://v3.fal.media/files/penguin/5BYwynFzNslwk9gHhyBOo.png"
    }
  ],
  "usage": null,
  "image": [
    "https://v3.fal.media/files/penguin/5BYwynFzNslwk9gHhyBOo.png"
  ],
  "metadata": {
    "credits": 1,
    "height": 1024,
    "images": [
      {
        "image_id": "c246cd3a-a9ae-44ee-b3b2-fc53159e9b01",
        "image_invariants": {
          "preset": "realistic_image"
        },
        "transparent": false,
        "vector_image": false
      }
    ],
    "random_seed": 21,
    "request_id": "c4672061-a521-4346-8721-ff2596b05ea3",
    "transform_model": "recraftv3",
    "width": 1280
  },
  "timings": null
}