# Krea 2 Medium - Core.Today AI API

> A lower-cost variant of Krea 2 Large, trading some fidelity for faster and cheaper generation while keeping the same photorealistic style focus.

- **Provider**: Krea AI
- **Model ID**: krea/krea-2-medium
- **Category**: Image Generation
- **Credits**: 70 per image
- **Speed**: Fast
- **Quality**: Standard

## Features
- Cheaper, faster sibling of Krea 2 Large with the same photorealistic style focus
- Creativity slider (raw/low/medium/high) controls how far the model deviates from the literal prompt
- Style reference images (up to 10) transfer a visual style to the output
- Krea moodboard support for reusable style/mood presets
- 8 aspect ratio presets from 1:1 to 2.35:1 cinematic
- Seed control for reproducible generations

## Use Cases
- Fast photorealistic concept drafts before committing to a high-fidelity render
- Bulk product/lifestyle image generation with consistent style via style reference images
- Marketing/social content that needs many quick variations rather than one polished piece
- Applying a saved Krea moodboard consistently across a campaign's visuals

## 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
A quick photorealistic draft using the default creativity level and a 4:3 aspect ratio.
```json
{
  "model": "krea/krea-2-medium",
  "input": {
    "prompt": "A ceramic coffee mug on a wooden table near a window, soft morning light, shallow depth of field",
    "aspect_ratio": "4:3",
    "creativity": "medium"
  }
}
```

### Style-matched variation from a reference image
Transfers the look of a style reference image onto a new scene at moderate strength.
```json
{
  "model": "krea/krea-2-medium",
  "input": {
    "prompt": "A city street at dusk with neon signs reflecting on wet pavement",
    "aspect_ratio": "16:9",
    "style_reference_images": [
      "https://example.com/reference-style.jpg"
    ],
    "style_reference_strength": 0.5
  }
}
```

## 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
- Start with creativity=low or medium to keep close prompt adherence; raw is the most literal, high gives the model the most creative freedom
- Use style_reference_images with style_reference_strength around 0.5 as a starting point, then adjust up or down
- If fidelity matters more than cost, compare against Krea 2 Large — this model trades some quality for speed and price
- Set seed when iterating on a specific composition to keep results reproducible

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