> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Krea 2

> Справочник API Krea 2: модели, параметры, цены и генеративные слайдеры нашей первой базовой модели изображений, созданной для творческого контроля.

![](https://s.krea.ai/docs/krea-2-hero.webp)

# Krea 2

Наша первая базовая модель генерации изображений — созданная с нуля для полного творческого контроля.

# Krea 2

Наша первая базовая модель генерации изображений — созданная с нуля для полного творческого контроля.

Krea 2 — наша первая базовая модель генерации изображений, обученная полностью с нуля, чтобы дать вам полный контроль над внешним видом, настроением и творческим направлением каждого создаваемого изображения.

> [!NOTE]
>
> [Krea 3](https://www.krea.ai/docs/developers/krea-3/overview.md) — наша новейшая модель изображений для быстрой генерации и точного редактирования по инструкциям. Продолжайте использовать Krea 2 для взвешенных референсов стиля, мудбордов, LoRA и генеративных ползунков; эти элементы управления не взаимозаменяемы с референсными изображениями Krea 3.

**Чем она выделяется:**

* **Эстетическое разнообразие** — Krea 2 умеет генерировать широкий диапазон стилей, особенно сильна в художественных и выразительных направлениях, которые другие модели обычно «сглаживают».
* **Style transfer** — самая продвинутая система переноса стиля из доступных. Извлекайте стиль одного или нескольких референсов и применяйте его к результатам с высокой точностью.
* **Настраиваемая креативность** — `creativity` — это реальный параметр, который вы можете регулировать. На высоких значениях модель добавляет эстетическую глубину, интерпретацию и визуальное богатство тому, что вы ей даёте.
* **Moodboards** — передайте целый moodboard из десятков изображений, и Krea 2 поймёт общее творческое направление, выдавая результаты, соответствующие ему.

[Открыть галереюСотни результатов Krea 2 вместе с их prompt.](https://www.krea.ai/k2-feed)

## Выберите вариант

API Krea 2 поставляется в двух вариантах. Оба поддерживают одну и ту же публичную форму запроса — различия сводятся к скорости, размеру модели, этапу обучения и характеру выдаваемых результатов.

> [card] Krea 2 Medium
>
> Меньше, быстрее, экономичнее. Масштабное пост-обучение делает результаты особенно стабильными и согласованными между генерациями.
>
> **Сильнее всего в:** иллюстрации, аниме, живописи и других выразительных или художественных стилях.

> [card] Krea 2 Large
>
> Более чем вдвое больше Medium, с более мягким пост-обучением. Результаты получаются более «сырыми», текстурными и гибкими — в лучших случаях Large выдаёт результаты, недоступные Medium.
>
> **Сильнее всего в:** фотореализме, «сыром» виде (размытие движения, зерно, низкий динамический диапазон), выразительных и художественных стилях.

> [!TIP]
>
> **Не уверены, с чего начать?** Используйте Medium для стабильных универсальных результатов, а Large — когда вам нужны самая богатая текстура или фотореализм.

## Тарифы

| Вариант | Text-to-image | Со style references | С moodboards |
| - | - | - | - |
| **Medium** | \$0.030 | \$0.035 | \$0.040 |
| **Large** | \$0.060 | \$0.065 | \$0.070 |

> [!NOTE]
>
> Сочетание moodboards **со** style references не увеличивает цену за генерацию — вы платите по тарифу moodboard (\$0.040 Medium / \$0.070 Large).

## Эндпоинты

| Вариант | Эндпоинт |
| - | - |
| **Medium** | `POST /generate/image/krea/krea-2/medium` |
| **Large** | `POST /generate/image/krea/krea-2/large` |

## Быстрый старт

Отправьте запрос на генерацию и опрашивайте результат. Все запросы требуют Bearer token — см. [API Keys & Billing](https://www.krea.ai/docs/developers/api-keys-and-billing.md), если у вас его ещё нет.

```javascript Node.js theme={"theme":{"light":"github-light-default","dark":"vesper"}}
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const result = await krea.subscribe("image/krea/krea-2/medium", {
  input: {
    prompt: "a cinematic glass cabin beside a frozen lake at sunrise",
    aspect_ratio: "16:9",
    resolution: "1K",
  },
});

// https://gen.krea.ai/images/80ead844-02a6-467d-ba9e-fcd401bcb9a6.png
console.log(result.data?.urls[0]);
```

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl -X POST https://api.krea.ai/generate/image/krea/krea-2/medium \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic product photo of a glass lamp on a marble table",
    "aspect_ratio": "4:5",
    "resolution": "1K",
    "creativity": "medium"
  }'

# Then poll the returned job_id
curl https://api.krea.ai/jobs/<job_id> \
  -H "Authorization: Bearer $KREA_API_KEY"
```

```python Python theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import os
import time
import requests

API_BASE = "https://api.krea.ai"
API_TOKEN = os.environ["KREA_API_KEY"]

def wait_for_job(job_id):
    while True:
        response = requests.get(
            f"{API_BASE}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_TOKEN}"},
        )
        response.raise_for_status()
        job = response.json()
        if job["status"] == "completed":
            return job
        if job["status"] in ("failed", "cancelled"):
            raise RuntimeError(f"Job {job['status']}")
        time.sleep(3)

response = requests.post(
    f"{API_BASE}/generate/image/krea/krea-2/medium",
    headers={
        "Authorization": f"Bearer {API_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "A cinematic product photo of a glass lamp on a marble table",
        "aspect_ratio": "4:5",
        "resolution": "1K",
        "creativity": "medium",
    },
)
response.raise_for_status()
job = wait_for_job(response.json()["job_id"])
print(job["result"]["urls"])
```

```go Go theme={"theme":{"light":"github-light-default","dark":"vesper"}}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"
)

const apiBase = "https://api.krea.ai"

func waitForJob(client *http.Client, jobID, token string) (map[string]any, error) {
	for {
		req, _ := http.NewRequest("GET", fmt.Sprintf("%s/jobs/%s", apiBase, jobID), nil)
		req.Header.Set("Authorization", "Bearer "+token)
		resp, err := client.Do(req)
		if err != nil {
			return nil, err
		}
		var job map[string]any
		json.NewDecoder(resp.Body).Decode(&job)
		resp.Body.Close()
		switch job["status"] {
		case "completed":
			return job, nil
		case "failed", "cancelled":
			return nil, fmt.Errorf("job %s", job["status"])
		}
		time.Sleep(3 * time.Second)
	}
}

func main() {
	token := os.Getenv("KREA_API_KEY")
	client := &http.Client{}

	payload, _ := json.Marshal(map[string]any{
		"prompt":       "A cinematic product photo of a glass lamp on a marble table",
		"aspect_ratio": "4:5",
		"resolution":   "1K",
		"creativity":   "medium",
	})

	req, _ := http.NewRequest("POST", apiBase+"/generate/image/krea/krea-2/medium", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer "+token)
	req.Header.Set("Content-Type", "application/json")

	resp, _ := client.Do(req)
	var created map[string]any
	json.NewDecoder(resp.Body).Decode(&created)
	resp.Body.Close()

	job, err := waitForJob(client, created["job_id"].(string), token)
	if err != nil {
		panic(err)
	}
	fmt.Println(job["result"])
}
```

> [!TIP]
>
> Генерации Krea 2 Large могут выполняться дольше, поэтому для production-нагрузок предпочтительнее использовать заголовок [`X-Webhook-URL`](https://www.krea.ai/docs/developers/webhooks) вместо опроса.

## Параметры

`krea-2/medium` и `krea-2/large` принимают одинаковое публичное тело запроса.

| Поле | Тип | Примечания |
| - | - | - |
| `prompt` | string | **Обязательно.** Текстовый prompt с описанием изображения. |
| `aspect_ratio` | string | Одно из `1:1`, `4:3`, `3:2`, `16:9`, `2.35:1`, `4:5`, `2:3`, `9:16`. |
| `resolution` | string | Сейчас поддерживается только `1K`. |
| `seed` | number | Опционально. Используйте одинаковые seed + prompt для воспроизведения генерации. |
| `creativity` | enum | `raw`, `low`, `medium` (по умолчанию), `high`. См. ниже. |
| `image_style_references` | array | Опционально. См. [Style transfer](https://www.krea.ai/docs/developers/krea-2/style-transfer.md). |
| `moodboards` | array | Опционально. См. [Moodboards](https://www.krea.ai/docs/developers/krea-2/moodboards.md). Максимум 1 moodboard на запрос. |
| `styles` | array | Опционально — обученные стили (LoRA). |
| `intensity` | integer | Опционально. От `-100` до `100`, по умолчанию `0`. См. [Generative sliders](https://www.krea.ai/docs/developers/krea-2/generative-sliders.md). |
| `complexity` | integer | Опционально. От `-100` до `100`, по умолчанию `0`. См. [Generative sliders](https://www.krea.ai/docs/developers/krea-2/generative-sliders.md). |
| `movement` | integer | Опционально. От `-100` до `100`, по умолчанию `0`. См. [Generative sliders](https://www.krea.ai/docs/developers/krea-2/generative-sliders.md). |

### Creativity

`creativity` определяет, насколько широко модель развивает то, что вы написали. Когда prompt короткий или неопределённый, модель сама дополняет недостающее — стиль, композицию, ракурс камеры, цветовую палитру, — и `creativity` решает, какую свободу она при этом берёт.

> [accordion] raw — без расширения
>
> Модель отображает только то, что вы явно описали. Лучше всего подходит для жёстко арт-режиссированных prompt, где каждая деталь уже указана.

> [accordion] low — близко к prompt
>
> Минимальное расширение. Модель остаётся близко к буквальному prompt, но заполняет очевидные пробелы.

> [accordion] medium — сбалансированно (по умолчанию)
>
> Поведение по умолчанию. Модель добавляет разумную интерпретацию, не сильно отклоняясь от замысла prompt.

> [accordion] high — выразительная интерпретация
>
> Сильное расширение. Модель берёт существенную творческую свободу в стиле, настроении и эстетике — лучше всего для коротких или открытых prompt, когда вы хотите, чтобы модель вас удивила.

## Подробнее о возможностях

> [card] [Style transfer](https://www.krea.ai/docs/developers/krea-2/style-transfer.md)
>
> Извлекайте стиль одного или нескольких референсов и применяйте его к результатам с настраиваемой силой.

> [card] [Moodboards](https://www.krea.ai/docs/developers/krea-2/moodboards.md)
>
> Используйте moodboard Krea, чтобы задать общее визуальное направление — палитру, текстуру, настроение и композицию.

> [card] [Генеративные слайдеры](https://www.krea.ai/docs/developers/krea-2/generative-sliders.md)
>
> Управляйте интенсивностью, сложностью и движением каждой генерации, не переписывая prompt.

## Open source

Krea 2 также доступна как open-source-релиз, если вы предпочитаете развернуть или дообучить модель самостоятельно вместо (или вместе с) обращений к размещённому API. На Hugging Face опубликованы два чекпоинта:

* **Krea 2 RAW** — недистиллированный базовый чекпоинт. Разнообразный и податливый, предназначенный для fine-tuning, post-training и обучения LoRA.
* **Krea 2 Turbo** — 8-шаговый дистиллированный чекпоинт, созданный для быстрого text-to-image-инференса. LoRA, обученные на RAW, рассчитаны на то, чтобы аккуратно применяться к Turbo.

| Ресурс | Ссылка |
| - | - |
| Чекпоинты на Hugging Face | [huggingface.co/krea/Krea-2-Raw](https://krea.ai/krea-2/huggingface) |
| Код модели на GitHub | [github.com/krea-ai/krea-2](https://krea.ai/krea-2/github) |
| Технический отчёт | [Технический отчёт Krea 2](https://krea.ai/krea-2/technical-report) |

### Лицензирование

Open-source-релиз поставляется по двум лицензионным трекам:

* **[Community License](https://krea.ai/krea-2-licensing)** — бесплатное, неисключительное использование для исследовательских, личных и некоммерческих проектов, а также коммерческое использование ниже порога по выручке. Подпадает под [Acceptable Use Policy](https://krea.ai/krea-2-use-policy).
* **[Commercial License](https://krea.ai/krea-2-commercial-license)** — корпоративные условия для коммерческого использования, превышающего порог по выручке Community License. Связь: `opensource@krea.ai`.

> [!NOTE]
>
> Размещённый Krea 2 API, описанный на этой странице, регулируется стандартными [условиями API](https://www.krea.ai/docs/developers/api-keys-and-billing.md) — чтобы вызывать `krea-2/medium` или `krea-2/large`, принимать open-source-лицензию не нужно.

## API reference

Krea 2 Medium logo

### [Krea 2 Medium](https://www.krea.ai/docs/api-reference/krea/krea-2-medium.md)

Быстрее, дешевле, стабильно работает с иллюстрацией, аниме и выразительными стилями.

Krea 2 Large logo

### [Krea 2 Large](https://www.krea.ai/docs/api-reference/krea/krea-2-large.md)

Более мощная — фотореализм, «сырые» текстуры и самые гибкие результаты.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.