# Krea 2 Large - Core.Today AI API

> Krea AI's flagship text-to-image model, focused on photorealistic output with strong prompt adherence. Supports style-reference and moodboard-guided generation for consistent visual direction.

- **Provider**: Krea AI
- **Model ID**: krea/krea-2-large
- **Category**: Image Generation
- **Credits**: 140 per image (fixed price)
- **Speed**: Medium
- **Quality**: High

## Features
- Photorealistic output with strong prompt adherence
- Style-reference transfer from up to 10 images with adjustable strength
- Moodboard-guided generation via the Krea webapp
- Adjustable creativity control from literal (raw) to highly interpretive (high)
- Wide range of aspect ratio presets including ultra-wide 2.35:1
- Seed control for reproducible generations

## Use Cases
- Photorealistic product and lifestyle photography
- Brand campaigns that need consistent visual direction via moodboards
- Image series with consistent style using reference images
- Cinematic ultra-wide (2.35:1) compositions
- Reproducible generation for creative A/B testing with seed control

## 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 describing the image.

### Optional
- **aspect_ratio**: string (default: 1:1) - Aspect ratio of the generated image.
  Options: 1:1, 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3, 9:16
- **creativity**: string (default: medium) - How far the model expands on your prompt. 'raw' renders only what you describe; 'low' fills in obvious gaps; 'medium' adds reasonable interpretation; 'high' takes meaningful creative liberty.
  Options: raw, low, medium, high
- **style_reference_images**: array (default: []) - Up to 10 reference images whose style should be transferred to the output. Their style is extracted and applied with the strength controlled by `style_reference_strength`.
- **style_reference_strength**: number (default: 0.5) - How strongly to apply the style of the reference images. 0 means no influence, 1 means the style dominates. Applied to all style reference images.
- **moodboard_id**: string - Optional Krea moodboard UUID. Moodboards must first be created in the Krea webapp (https://www.krea.ai/moodboards). Get the UUID from the moodboard share URL: `?share=<uuid>`.
- **moodboard_strength**: number (default: 0.35) - How strongly the moodboard shapes the output.
- **seed**: integer - Random seed. Set for reproducible generation.

## Examples

### Photorealistic Product Shot
Studio-quality product photography from a text prompt alone
```json
{
  "model": "krea/krea-2-large",
  "input": {
    "prompt": "A photorealistic studio shot of a matte black ceramic coffee mug on a warm oak wood table, soft natural window light from the left, shallow depth of field",
    "aspect_ratio": "4:3",
    "creativity": "low"
  }
}
```

### Style-Referenced Campaign Image
Applying a brand's visual style from reference images to a new scene
```json
{
  "model": "krea/krea-2-large",
  "input": {
    "prompt": "A model wearing a linen summer dress walking through a sunlit olive grove",
    "style_reference_images": [
      "https://example.com/brand-style-1.jpg",
      "https://example.com/brand-style-2.jpg"
    ],
    "style_reference_strength": 0.7,
    "aspect_ratio": "2.35:1"
  }
}
```

## 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
- Use creativity: raw when you need the model to render exactly what you describe with no embellishment
- Combine style_reference_images with moodboard_id for tighter, more consistent art direction across a campaign
- Set seed for reproducible outputs when running A/B creative tests
- 2.35:1 is a strong choice for cinematic, ultra-wide compositions

## Documentation
https://replicate.com/krea/krea-2-large