Recraft - Image Generator

Generate high-quality images using Recraft's advanced AI models. Recraft is specifically optimized for professional designers, offering exceptional control over styles, including state-of-the-art vector illustration and icon generation, alongside high-fidelity raster images.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Parameters

Parameter	Type	Required	Description
type	string	Yes	Feature type identifier. Must be IMAGE_GENERATOR
model	string	Yes	AI model identifier. Must be recraft
promptObject	object	Yes	Configuration object containing generation parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
prompt	string	Yes	Text description of the image to generate	-
task_type	string	No	The specific Recraft model version to use	recraftv3
style	string	No	The artistic style of the image (V2/V3 only)	-
substyle	string	No	Subtle style of the image (V2/V3 only)	-
size	string	No	Dimensions of the generated image	1024x1024
n	number	No	Number of images to generate (1-4)	1
negative_prompt	string	No	Description of elements to exclude from the image	-

Supported Models (task_type)

Model	Description
recraftv4	Latest V4 model for high-quality raster image generation
recraftv4_vector	V4 model optimized for vector illustration output (SVG)
recraftv4_pro	V4 Pro model with higher resolution output (up to 2048px+)
recraftv4_pro_vector	V4 Pro model for high-quality vector illustration output (SVG)
recraftv3	High-performance model for superior quality and consistency
recraftv2	Reliable model for high-quality artistic and vector styles

note

style and substyle are only applicable for recraftv2 and recraftv3. They are ignored for V4 models.

Size Options by Model

recraftv4

1024x1024, 1536x768, 768x1536, 1280x832, 832x1280, 1216x896, 896x1216, 1152x896, 896x1152, 832x1344, 1280x896, 896x1280, 1344x768, 768x1344

recraftv4_vector / recraftv4_pro_vector (aspect ratios)

1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9, 9:16

recraftv4_pro

2048x2048, 3072x1536, 1536x3072, 2560x1664, 1664x2560, 2432x1792, 1792x2432, 2304x1792, 1792x2304, 1664x2688, 2560x1792, 1792x2560, 2688x1536, 1536x2688

recraftv3 / recraftv2

1024x1024, 1365x1024, 1024x1365, 1536x1024, 1024x1536, 1820x1024, 1024x1820, 1024x2048, 2048x1024, 1434x1024, 1024x1434, 1024x1280, 1280x1024, 1024x1707, 1707x1024

Popular Style Options (V2 / V3 only)

Style	Best For
vector_illustration	Clean, scalable-style illustrations
realistic_image	Photorealistic results and high-fidelity textures
digital_illustration	Modern digital artwork and paintings

Use the Get Recraft Style List API to retrieve all available styles and substyles dynamically (V2/V3 only).

Get Recraft Style List API

Before generating images with V2 or V3 models, you can retrieve the complete list of available styles and substyles for each model version.

Endpoint

GEThttps://api.1min.ai/recraft/styles

Request Headers

Field	Value
API-KEY	<api-key>

Query Parameters

Parameter	Type	Required	Description
taskType	string	Yes	Model version: recraftv3 or recraftv2

note

The style list API is only available for recraftv2 and recraftv3. V4 models (recraftv4, recraftv4_vector, recraftv4_pro, recraftv4_pro_vector) do not use styles.

Response Format

{
"styleList": [
  {
    "model": "recraftv2_vector",
    "style": "icon"
  },
  {
    "model": "recraftv2_vector",
    "style": "icon",
    "substyle": "broken_line"
  }
]
"total": 2
}

Example Request

cURL

curl --location 'https://api.1min.ai/api/recraft/styles?taskType=recraftv3' \
--header 'API-KEY: <api-key>'

JavaScript

fetch('https://api.1min.ai/api/recraft/styles?taskType=recraftv3', {
method: 'GET',
headers: {
  'API-KEY': 'YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));

Python

import requests

url = "https://api.1min.ai/api/recraft/styles"
headers = {
"API-KEY": "YOUR_API_KEY"
}
params = {
"taskType": "recraftv3"
}

response = requests.get(url, headers=headers, params=params)
styles = response.json()

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/recraft/styles

Model Version *

Choose which Recraft model styles to retrieve (V2/V3 only)

Recraft V3Recraft V2

Generated cURL Command:

curl -X GET "https://api.1min.ai/api/recraft/styles?taskType=recraftv3" \
  -H "API-KEY: <your-api-key>"

Image Generation Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "recraft",
"promptObject": {
  "prompt": "A futuristic mountain landscape in vector style",
  "task_type": "recraftv3",
  "style": "vector_illustration",
  "substyle": "bold_stroke",
  "size": "1024x1024",
  "n": 1
}
}'

JavaScript

const body = JSON.stringify({
type: 'IMAGE_GENERATOR',
model: 'recraft',
promptObject: {
  prompt: 'A futuristic mountain landscape in vector style',
  task_type: 'recraftv3',
  style: 'vector_illustration',
  substyle: 'bold_stroke',
  size: '1024x1024',
  n: 1
}
});

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'API-KEY': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: body
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"API-KEY": "YOUR_API_KEY"
}

payload = {
"type": "IMAGE_GENERATOR",
"model": "recraft",
"promptObject": {
"prompt": "A futuristic mountain landscape in vector style",
"task_type": "recraftv3",
"style": "vector_illustration",
"substyle": "bold_stroke",
"size": "1024x1024",
"n": 1
}
}

response = requests.post(url, headers=headers, json=payload)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Recraft

Prompt *

Describe the image you want to generate

A futuristic mountain landscape in vector style

Model Version

Choose which Recraft model to use

Recraft V4Recraft V4 VectorRecraft V4 ProRecraft V4 Pro VectorRecraft V3Recraft V2

Style (V2/V3 only)

Choose the artistic style (not applicable for V4 models)

Vector IllustrationIconRealistic ImageDigital Illustration

Substyle (V2/V3 only)

Subtle style identifier (e.g., 'bold_stroke') — not applicable for V4 models

Image Size

Dimensions of the generated image (available options vary by model version)

1024x10241365x10241024x13651536x10241024x15361820x10241024x18201024x20482048x10241434x10241024x14341024x12801280x10241024x17071707x1024

Number of Images

Number of images to generate (1-4)

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_GENERATOR",
  "model": "recraft",
  "promptObject": {
    "prompt": "A futuristic mountain landscape in vector style",
    "task_type": "recraftv3",
    "style": "vector_illustration",
    "substyle": "bold_stroke",
    "size": "1024x1024",
    "n": 1
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "r1e2c3r4-a5f6-7890-abcd-ef1234567894",
  "userId": "user-12345",
  "teamId": "team-67890",
  "teamUser": {
    "teamId": "team-67890",
    "userId": "user-12345",
    "userName": "John Doe",
    "userAvatar": "https://example.com/avatar.jpg",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 50000,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2026-01-02T13:13:31.000Z",
    "updatedBy": "SYSTEM"
  },
  "model": "recraft",
  "type": "IMAGE_GENERATOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2026-01-02T13:13:31.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "A futuristic mountain landscape in vector style",
      "task_type": "recraftv3",
      "style": "vector_illustration",
      "size": "1024x1024",
      "n": 1
    },
    "resultObject": [
      "images/2026_01_02_13_13_31_002_generated_image.png"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/images/2026_01_02_13_13_31_002_generated_image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=EXAMPLE_CREDENTIAL&X-Amz-Date=20260102T131331Z&X-Amz-Expires=604800&X-Amz-Signature=example_signature&X-Amz-SignedHeaders=host&x-id=GetObject"
}
}

Use Cases

Professional Design

• Marketing Illustrations: Quality vector-style art for websites and ad campaigns.
• UI/UX Design: Consistent icon sets and interface elements.

Branding

• Logo Concepts: Generate diverse logo and brand asset ideas.
• Consistent Visuals: Maintain a unified style across multiple generated assets.

Notes

• Recraft is exceptionally strong at following detailed style instructions.
• For vector-style outputs (recraftv4_vector, recraftv4_pro_vector, or V2/V3 with vector_illustration style), the model produces SVG files with clean lines and professional-grade compositions.
• Credits are calculated based on the selected model (task_type) and the quantity of images generated.