# Recraft V4.1 - Core.Today AI API

> Recraft's latest image generation model, built around design taste — strong prompt accuracy, art-directed composition and integrated text rendering at standard (~1MP) resolution.

- **Provider**: Recraft
- **Model ID**: recraft-ai/recraft-v4.1
- **Category**: Image Generation
- **Credits**: 93 per image
- **Speed**: Medium
- **Quality**: High

## Features
- Design-first composition with strong prompt accuracy
- Integrated text rendering for headlines and labels
- Wide range of styles from photography to illustration
- 15 aspect ratio presets or 14 exact pixel sizes
- Long prompts up to 10,000 characters

## Use Cases
- Marketing and social media visuals with on-image text
- Editorial and architectural imagery
- Brand and design exploration at low cost
- Blog and landing-page hero images

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for image generation (up to 10,000 characters)

### Optional
- **aspect_ratio**: string (default: Not set) - Aspect ratio of the generated image. When set, size is ignored
  Options: Not set, 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 1:2, 2:1, 14:10, 10:14, 4:5, 5:4, 6:10
- **size**: string (default: 1024x1024) - Width and height of the generated image. Size is ignored if an aspect ratio is set.
  Options: 1024x1024, 1536x768, 768x1536, 1280x832, 832x1280, 1216x896, 896x1216, 1152x896, 896x1152, 832x1344, 1280x896, 896x1280, 1344x768, 768x1344

## Examples

### Architectural photography
Art-directed interior scene at the default 1024x1024 size
```json
{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "prompt": "A brutalist concrete library interior at golden hour — shafts of amber light cut through narrow slit windows and fall across tiered balconies lined with thousands of identical navy-blue hardcover books. A single reader sits far below in a pool of direct light. Wide-angle tilt-shift lens from above, architectural photography.",
    "aspect_ratio": "Not set",
    "size": "1024x1024"
  }
}
```

### Social banner with text
Wide banner using an aspect ratio preset
```json
{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "prompt": "A clean flat-design banner for a coffee shop spring promotion with the headline 'Spring Blend' in bold serif type, pastel palette",
    "aspect_ratio": "16:9"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Set aspect_ratio for common ratios; leave it 'Not set' and use size for exact pixel dimensions
- Put the exact text you want rendered in quotes inside the prompt
- Use Recraft V4.1 Pro for ~2048px print-ready output, or the SVG variants for vector files
- Each call returns one image at a flat 93 credits regardless of size

## Documentation
https://replicate.com/recraft-ai/recraft-v4.1