Skip to main content

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

Request Headers

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_GENERATOR
modelstringYesAI model identifier. Must be recraft
promptObjectobjectYesConfiguration object containing generation parameters

Prompt Object Parameters

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
task_typestringNoThe specific Recraft model version to userecraftv3
stylestringNoThe artistic style of the image-
substylestringNoSubtle style of the image-
sizestringNoDimensions of the generated image1024x1024
nnumberNoNumber of images to generate (1-4)1
negative_promptstringNoDescription of elements to exclude from the image-

Supported Models (task_type)

ModelDescription
recraftv3Latest high-performance model for superior quality and consistency
recraftv2Reliable model for high-quality artistic and vector styles
StyleBest For
vector_illustrationClean, scalable-style illustrations
realistic_imagePhotorealistic results and high-fidelity textures
digital_illustrationModern digital artwork and paintings

Use the Get Recraft Style List API to retrieve all available styles and substyles dynamically.

Get Recraft Style List API

Before generating images, you can retrieve the complete list of available styles and substyles for each Recraft model version.

Endpoint

Request Headers

FieldValue
API-KEY<api-key>

Query Parameters

ParameterTypeRequiredDescription
taskTypestringYesModel version: recraftv3 or recraftv2

Response Format

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

Example Request

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

Interactive Playground

API Playground

https://api.1min.ai/api/recraft/styles
Choose which Recraft model styles to retrieve

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 --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
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Describe the image you want to generate
Choose which Recraft model to use
Choose the artistic style
Subtle style identifier (e.g., 'bold_stroke')
Dimensions of the generated image
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, the model provides clean lines and professional-grade compositions.
  • Credits are calculated based on the selected model (task_type) and the quantity of images generated.