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
| 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 | - |
substyle | string | No | Subtle style of the image | - |
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 |
|---|---|
recraftv3 | Latest high-performance model for superior quality and consistency |
recraftv2 | Reliable model for high-quality artistic and vector styles |
Popular Style Options
| 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.
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
| Field | Value |
|---|---|
| API-KEY | <api-key> |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
taskType | string | Yes | Model 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
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/recraft/styles?taskType=recraftv3' \
--header 'API-KEY: <api-key>'
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));
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
https://api.1min.ai/api/recraft/stylesChoose 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
- JavaScript
- Python
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
}
}'
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
})
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
https://api.1min.ai/api/featuresDescribe 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.