# Recraft V3 - Core.Today AI API

> Recraft V3 (code-named red_panda) is a text-to-image model with the ability to generate long texts, and images in a wide list of styles. SOTA in image generation per the Artificial Analysis Text-to-Image Benchmark.

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

## Features
- State-of-the-art benchmark performance among text-to-image models
- Long, accurate in-image text rendering
- 19 curated styles spanning realistic photography and digital illustration
- 15 fixed size presets in addition to aspect ratio control
- Broad aspect ratio range from 1:2 to 2:1

## Use Cases
- Brand and marketing graphics needing precise, long text
- Illustration work across many distinct visual styles
- Posters and social media graphics at exact pixel sizes
- Photorealistic product or studio-style imagery

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

### Optional
- **size**: string (default: 1024x1024) - Width and height of the generated image. Ignored if an aspect ratio is set
  Options: 1024x1024, 1365x1024, 1024x1365, 1536x1024, 1024x1536, 1820x1024, 1024x1820, 1024x2048, 2048x1024, 1434x1024, 1024x1434, 1024x1280, 1280x1024, 1024x1707, 1707x1024
- **style**: string (default: any) - Style of the generated image (realistic photography or digital illustration variants)
  Options: any, realistic_image, digital_illustration, digital_illustration/pixel_art, digital_illustration/hand_drawn, digital_illustration/grain, digital_illustration/infantile_sketch, digital_illustration/2d_art_poster, digital_illustration/handmade_3d, digital_illustration/hand_drawn_outline, digital_illustration/engraving_color, digital_illustration/2d_art_poster_2, realistic_image/b_and_w, realistic_image/hard_flash, realistic_image/hdr, realistic_image/natural_light, realistic_image/studio_portrait, realistic_image/enterprise, realistic_image/motion_blur
- **aspect_ratio**: string (default: Not set) - Aspect ratio of the generated image. Overrides size when set
  Options: Not set, 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 1:2, 2:1, 7:5, 5:7, 4:5, 5:4, 3:5, 5:3

## Examples

### Wildlife Photography
A realistic wildlife photography style image
```json
{
  "model": "recraft-ai/recraft-v3",
  "input": {
    "prompt": "a wildlife photography photo of a red panda using a laptop in a snowy forest",
    "size": "1365x1024",
    "style": "any"
  }
}
```

## 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
- aspect_ratio overrides size when both are set — use one or the other, not both
- style has 19 fine-grained sub-styles under the realistic_image and digital_illustration families
- Best-in-class for embedding long, legible text directly in the image
- Use the fixed size presets when you need an exact pixel dimension rather than a ratio

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