# Recraft V4.1

> 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**: replicate
- **Model ID**: recraft-ai/recraft-v4.1
- **Category**: image_generation
- **Credits**: 93 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `size` (string, optional): Width and height of the generated image. Size is ignored if an aspect ratio is set. (Default: `1024x1024`; Options: `1024x1024`, `1536x768`, `768x1536`, `1280x832`, `832x1280`, `1216x896`, `896x1216`, `1152x896`, `896x1152`, `832x1344`, `1280x896`, `896x1280`, `1344x768`, `768x1344`)
- `prompt` (string, **required**): Text prompt for image generation (up to 10,000 characters)
- `aspect_ratio` (string, optional): Aspect ratio of the generated image. When set, size is ignored. (Default: `Not set`; 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`)

## Example Request

```json
{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "size": "1024x1024",
    "prompt": "A brutalist concrete library interior at golden hour \u2014 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"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

recraft, text-to-image, image-generation, typography

## Documentation

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