# Recraft V4 - Core.Today AI API

> Recraft's next-generation text-to-image model, improving on V3's typography, style range, and prompt adherence for production-grade brand and design assets.

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

## Features
- Improved typography handling over Recraft V3
- Wider style range and stronger prompt adherence
- Long-form prompts up to 10,000 characters
- 15 fixed output sizes plus 15 aspect ratio presets
- Aimed at production-grade brand and design assets

## Use Cases
- Marketing and brand visuals where in-image text/typography accuracy matters
- Design assets that need an exact aspect ratio (social banners, print, packaging mockups)
- Illustrations and graphics meant for real production use, not just rough concepts

## 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
  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

### Brand poster with typography
A design asset that requires accurate on-image text rendering.
```json
{
  "model": "recraft-ai/recraft-v4",
  "input": {
    "prompt": "A minimalist poster for a coffee shop grand opening, bold headline text 'NOW OPEN', clean sans-serif typography, warm color palette",
    "aspect_ratio": "3:4"
  }
}
```

### Fixed-size packaging mockup
Uses an explicit size instead of an aspect ratio for exact output dimensions.
```json
{
  "model": "recraft-ai/recraft-v4",
  "input": {
    "prompt": "A clean product packaging mockup for a skincare bottle on a marble surface, studio lighting",
    "size": "1280x832"
  }
}
```

## 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 instead for exact pixel dimensions
- This model handles on-image typography better than V3 — good for posters, packaging mockups, and text-heavy designs
- Prompts can be long and detailed (up to 10,000 characters) for precise art direction

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