Krea AIMediumHigh

Krea 2 Large

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.

140 credits

per image (fixed price)

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

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt describing the image.
`aspect_ratio`	string	No	1:1	Aspect ratio of the generated image. 1:14:33:216:92.35:14:52:39:16
`creativity`	string	No	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. rawlowmediumhigh
`style_reference_images`	array	No	[]	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	No	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	No	-	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	No	0.35	How strongly the moodboard shapes the output.
`seed`	integer	No	-	Random seed. Set for reproducible generation.

How to Provide File Input

There are 3 ways to provide files for the style_reference_images parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=krea/krea-2-large" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:style_reference_images=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "krea/krea-2-large",
  "input": {
    "prompt": "your prompt here",
    "style_reference_images": ["https://example.com/image.jpg"]
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Photorealistic Product Shot

Studio-quality product photography from a text prompt alone

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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"
  }
}'