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

# Stilübertragung

> Verwenden Sie ein oder mehrere Referenzbilder, um den Stil einer Krea 2-Generierung zu steuern, mit individuell einstellbarer Stärke pro Referenz.

Krea 2 wird mit dem leistungsfähigsten Stilübertragungssystem auf dem Markt ausgeliefert. Übergeben Sie ein einzelnes Referenzbild oder kombinieren Sie mehrere, und Krea 2 extrahiert den Stil und überträgt ihn auf Ihr Ergebnis – Sie entscheiden dabei, wie stark jede Referenz das endgültige Bild prägt.

## Beispiele

Jedes Beispiel zeigt die **Stilreferenz** links und das **generierte Ergebnis** rechts.

<div className="not-prose space-y-8">
  <div>
    <div className="grid grid-cols-2 gap-3">
      <img src="https://s.krea.ai/docs/krea-2/style-transfer-cat-ref.webp" alt="Stilreferenz: Cartoon, der durch Gras läuft" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />

      <img src="https://s.krea.ai/docs/krea-2/style-transfer-cat-out.webp" alt="Ergebnis: eine Katze, die seitwärts springt" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">Prompt: <em>a cat jumping sideways</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <img src="https://s.krea.ai/docs/krea-2/style-transfer-polar-bear-ref.webp" alt="Stilreferenz: 8-Bit-Pixel-Art-Raster" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />

      <img src="https://s.krea.ai/docs/krea-2/style-transfer-polar-bear-out.webp" alt="Ergebnis: ein Eisbär" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">Prompt: <em>a polar bear</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <img src="https://s.krea.ai/docs/krea-2/style-transfer-cowboy-ref.webp" alt="Stilreferenz: Skizze im Krea 1-Stil" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />

      <img src="https://s.krea.ai/docs/krea-2/style-transfer-cowboy-out.webp" alt="Ergebnis: ein Cowboy" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">Prompt: <em>a cowboy</em></p>
  </div>

  <div>
    <div className="grid grid-cols-2 gap-3">
      <img src="https://s.krea.ai/docs/krea-2/style-transfer-muppet-ref.webp" alt="Stilreferenz: Pferd im Sesamstraßen-Stil" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />

      <img src="https://s.krea.ai/docs/krea-2/style-transfer-muppet-out.webp" alt="Ergebnis: Katze und Hund im Muppets-Stil" className="rounded-lg w-full object-cover m-0" style={{ aspectRatio: "4/3" }} />
    </div>

    <p className="mt-2 text-sm text-gray-600 dark:text-gray-400">Prompt: <em>a scene from the live-action Muppets movie featuring a grey cat muppet and his dog friend</em></p>
  </div>
</div>

## So funktioniert es

<Steps>
  <Step title="Stellen Sie Ihre Referenz bereit">
    Sie können ein Bild auf drei Arten referenzieren: Senden Sie das Bild per `POST` an `/assets` und verwenden Sie die zurückgegebene URL, übergeben Sie eine externe URL direkt oder geben Sie einen Daten-URI an.
  </Step>

  <Step title="Per URL referenzieren">
    Fügen Sie die Bild-URL oder den Daten-URI in das Array `image_style_references` Ihrer `krea-2/medium`- oder `krea-2/large`-Anfrage ein.
  </Step>

  <Step title="Stärke einstellen">
    Setzen Sie `strength` pro Referenz auf einen Wert zwischen -2 und 2. \~0,6 ist ein guter Ausgangspunkt – erhöhen Sie ihn, damit der Stil dominiert, senken Sie ihn für einen dezenteren Einfluss.
  </Step>
</Steps>

## End-to-End-Beispiel

In diesem Beispiel wird eine lokale Datei als Stilreferenz hochgeladen und in einer Krea 2 Medium-Generierung verwendet.

<CodeGroup>
  ```javascript Node.js theme={null}
  // npm install @krea-ai/sdk
  import { openAsBlob } from "node:fs";
  import { Krea } from "@krea-ai/sdk";

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

  // 1. Upload the style reference
  const file = await openAsBlob("./style-reference.png", { type: "image/png" });
  const asset = await krea.assets.upload(file, {
    filename: "style-reference.png",
    description: "Style reference for Krea 2",
  });

  // 2. Generate with the reference
  const result = await krea.subscribe("image/krea/krea-2/medium", {
    input: {
      prompt: "A portrait of a dancer in a quiet studio",
      aspect_ratio: "4:3",
      resolution: "1K",
      creativity: "medium",
      image_style_references: [{ url: asset.image_url, strength: 0.6 }],
    },
  });

  console.log(result.data?.urls[0]);
  ```

  ```bash cURL theme={null}
  # 1. Upload the style reference
  curl -X POST https://api.krea.ai/assets \
    -H "Authorization: Bearer $KREA_API_TOKEN" \
    -F "file=@./style-reference.png" \
    -F "description=Style reference for Krea 2"
  # Response includes { "image_url": "https://..." }

  # 2. Generate with the reference (replace IMAGE_URL with the response above)
  curl -X POST https://api.krea.ai/generate/image/krea/krea-2/medium \
    -H "Authorization: Bearer $KREA_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "A portrait of a dancer in a quiet studio",
      "aspect_ratio": "4:3",
      "resolution": "1K",
      "creativity": "medium",
      "image_style_references": [
        { "url": "IMAGE_URL", "strength": 0.6 }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  import requests

  API_BASE = "https://api.krea.ai"
  API_TOKEN = os.environ["KREA_API_TOKEN"]
  headers = {"Authorization": f"Bearer {API_TOKEN}"}

  # 1. Upload the style reference
  with open("style-reference.png", "rb") as f:
      upload = requests.post(
          f"{API_BASE}/assets",
          headers=headers,
          files={"file": ("style-reference.png", f, "image/png")},
          data={"description": "Style reference for Krea 2"},
      )
  upload.raise_for_status()
  asset = upload.json()

  # 2. Generate with the reference
  generation = requests.post(
      f"{API_BASE}/generate/image/krea/krea-2/medium",
      headers={**headers, "Content-Type": "application/json"},
      json={
          "prompt": "A portrait of a dancer in a quiet studio",
          "aspect_ratio": "4:3",
          "resolution": "1K",
          "creativity": "medium",
          "image_style_references": [
              {"url": asset["image_url"], "strength": 0.6},
          ],
      },
  )
  generation.raise_for_status()
  print(generation.json())  # { "job_id": "..." } — poll /jobs/{id} for the result
  ```
</CodeGroup>

<Note>
  Die REST-Beispiele sind asynchron – `POST /generate/...` gibt sofort eine `job_id` zurück. Das Node.js-SDK-Beispiel verwendet `subscribe(...)`, das auf das fertige Ergebnis wartet. Lesen Sie [Job-Lebenszyklus](/developers/job-lifecycle) für das Polling-Muster oder verwenden Sie einen [Webhook](/developers/webhooks), um Polling ganz zu vermeiden.
</Note>

## Stärke einstellen

`strength` reicht von `-2` bis `2`. Einige Faustregeln:

* **\~0,3–0,5** – dezenter Einfluss; nützlich, wenn der Prompt führen soll und die Referenz Charakter hinzufügen soll.
* **\~0,6** – ausgewogener Ausgangspunkt für die meisten Anwendungsfälle.
* **\~0,8–1,0** – der Referenzstil dominiert; nützlich, wenn der Prompt allgemein gehalten ist und die visuelle Identität von der Referenz kommen soll.
* **Negative Werte** – treiben das Ergebnis von einem Referenzstil weg.

Wenn Ergebnisse entweder zu wörtlich (Referenz ist zu stark) oder zu generisch (Referenz ist zu schwach) wirken, passen Sie die Werte in Schritten von 0,1 an.

## Mehrere Referenzen kombinieren

Übergeben Sie mehrere Objekte in `image_style_references`, um Stile zu mischen. Jede Referenz kann ihre eigene `strength` haben.

```javascript Node.js theme={null}
const result = await krea.subscribe("image/krea/krea-2/medium", {
  input: {
    prompt: "A portrait of a dancer in a quiet studio",
    aspect_ratio: "4:3",
    resolution: "1K",
    image_style_references: [
      { url: assetA.image_url, strength: 0.6 },
      { url: assetB.image_url, strength: 0.4 },
    ],
  },
});
```

Die Referenzen werden additiv gemischt – beginnen Sie mit Stärken, die zusammen etwa `1,0` ergeben, und passen Sie von dort aus an.