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

> مرجع واجهة برمجة تطبيقات Krea 2 يغطي النماذج والمعاملات والأسعار وأشرطة التحكم التوليدية لأول نموذج صور تأسيسي مصمم للتحكم الإبداعي.

export const ModelOverviewCard = ({name, description, icon, href}) => {
  const resolvedIcon = (() => {
    if (typeof icon !== "string" || !icon.startsWith("/") || icon.startsWith("//")) return icon;
    if (typeof window === "undefined") return icon;
    const base = "/docs";
    const under = window.location.pathname === base || window.location.pathname.startsWith(base + "/");
    return under && !icon.startsWith(base + "/") ? base + icon : icon;
  })();
  return <a href={href} className="group relative block rounded-xl border border-gray-200 dark:border-gray-800 bg-white dark:bg-black overflow-hidden hover:border-black dark:hover:border-white transition-all duration-200 p-6">
      {}
      <div className="flex items-center justify-center w-8 h-8 rounded-lg mb-4 transition-colors duration-200">
        {icon && <img src={resolvedIcon} alt={`${name} logo`} className="w-8 h-8 object-contain transition-all duration-200" />}
      </div>

      {}
      <div className="space-y-2">
        <h3 className="text-lg font-semibold text-black dark:text-white transition-colors">
          {name}
        </h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 line-clamp-4">
          {description}
        </p>
      </div>

      {}
      <div className="absolute top-6 right-6 opacity-0 group-hover:opacity-100 transition-opacity duration-200">
        <svg className="w-4 h-4 text-black dark:text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
        </svg>
      </div>
    </a>;
};

export const HeroHeader = ({image, video, title, description}) => {
  return <div className="relative aspect-[2/1] h-[30vh] w-full rounded-lg overflow-hidden mb-8">
      {}
      {video && <video autoPlay muted loop playsInline className="absolute top-0 left-0 w-full h-full object-cover hidden md:block m-0" style={{
    zIndex: 1,
    objectPosition: "20% 20%"
  }}>
          <source src={video} type="video/webm" />
        </video>}

      {}
      <img src={image} alt="" className={`absolute top-0 left-0 m-0 w-full h-full object-cover ${video ? "md:hidden" : "block"}`} style={{
    zIndex: 1,
    objectPosition: "20% 20%"
  }} />

      {}
      <div className="absolute inset-0 bg-gradient-to-t from-black/70 via-black/30 to-black/10 flex flex-col justify-end p-8 dark:hidden" style={{
    zIndex: 2
  }}>
        <h1 className="text-4xl font-bold text-white m-0 drop-shadow-[0_2px_4px_rgba(0,0,0,0.5)]">
          {title}
        </h1>
        <p className="text-lg text-white/95 mt-2 drop-shadow-[0_1px_2px_rgba(0,0,0,0.5)]">
          {description}
        </p>
      </div>

      {}
      <div className="absolute inset-0 bg-gradient-to-t from-black/80 via-black/40 to-black/20 hidden dark:flex flex-col justify-end p-8" style={{
    zIndex: 2
  }}>
        <h1 className="text-4xl font-bold text-white m-0 drop-shadow-[0_2px_4px_rgba(0,0,0,0.5)]">
          {title}
        </h1>
        <p className="text-lg text-white/95 mt-2 drop-shadow-[0_1px_2px_rgba(0,0,0,0.5)]">
          {description}
        </p>
      </div>
    </div>;
};

<HeroHeader image="https://s.krea.ai/docs/krea-2-hero.webp" title="Krea 2" description="أول نموذج صور أساسي لنا — مبني من الصفر لمنحك تحكمًا إبداعيًا كاملًا." />

Krea 2 هو أول نموذج صور أساسي لنا، تم تدريبه بالكامل من الصفر ليمنحك تحكمًا تامًا في الشكل والإحساس والاتجاه الإبداعي لكل صورة تُولِّدها.

**ما الذي يميزه:**

* **التنوع الجمالي** — يستطيع Krea 2 توليد طيف واسع من الأساليب، مع قوة خاصة في الاتجاهات الفنية والتعبيرية التي تميل النماذج الأخرى إلى تسطيحها.
* **نقل الأسلوب** — أكثر أنظمة نقل الأسلوب تطورًا المتاحة. استخرج أسلوب صورة مرجعية واحدة أو عدة صور وطبِّقه على مخرجاتك بدقة.
* **إبداع قابل للضبط** — `creativity` هو معامل فعلي يمكنك تعديله. وعند القيم العالية، يضيف النموذج عمقًا جماليًا وتفسيرًا وثراءً بصريًا لأي مدخل تقدمه له.
* **لوحات المزاج (Moodboards)** — مرِّر لوحة مزاج كاملة تحتوي عشرات الصور وسيفهم Krea 2 الاتجاه الإبداعي العام، ويُنتج مخرجات تتماشى معه.

<a href="https://www.krea.ai/k2-feed" target="_blank" rel="noopener noreferrer" className="not-prose group flex items-center justify-between gap-4 my-8 rounded-xl !bg-black !text-white dark:!bg-white dark:!text-black hover:opacity-90 transition-opacity px-5 py-4">
  <div className="flex-1">
    <div className="text-base font-semibold">استكشف المعرض</div>
    <div className="text-sm opacity-80">مئات من مخرجات Krea 2 مع موجِّهاتها.</div>
  </div>

  <svg className="w-4 h-4 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24">
    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M14 5l7 7m0 0l-7 7m7-7H3" />
  </svg>
</a>

## اختر متغيرًا

تأتي واجهة Krea 2 البرمجية بمتغيرين. كلاهما يدعم نفس بنية الطلب العامة — والاختلافات تتلخص في السرعة وحجم النموذج ومرحلة التدريب وطابع المخرجات.

<CardGroup cols={1}>
  <Card title="Krea 2 Medium" icon="bolt">
    أصغر وأسرع وأكثر كفاءة من حيث التكلفة. تجعل مراحل ما بعد التدريب الموسَّعة المخرجاتِ ثابتةً ومتسقةً بشكل خاص عبر عمليات التوليد.

    **الأقوى في:** الرسوم التوضيحية والأنمي والرسم والأساليب التعبيرية أو الفنية الأخرى.
  </Card>

  <Card title="Krea 2 Large" icon="layer-group">
    أكبر بأكثر من ضعفي حجم Medium، مع تدريب لاحق أكثر ليونة. المخرجات أكثر خامًا وأكثر نسيجًا وأكثر مرونة — وفي أفضل حالاته، يُنتج Large نتائج لا يستطيع Medium مجاراتها.

    **الأقوى في:** الواقعية الفوتوغرافية، والمظاهر الخام (ضبابية الحركة، والحبيبات، والمدى الديناميكي المنخفض)، والأساليب التعبيرية والفنية.
  </Card>
</CardGroup>

<Tip>
  **لست متأكدًا من أيهما تبدأ به؟** استخدم Medium للحصول على مخرجات ثابتة لأغراض عامة، وLarge عندما تريد أغنى نسيج أو واقعية فوتوغرافية.
</Tip>

## التسعير

| المتغير    | نص إلى صورة | مع مراجع الأسلوب | مع لوحات المزاج |
| ---------- | ----------- | ---------------- | --------------- |
| **Medium** | \$0.030     | \$0.035          | \$0.040         |
| **Large**  | \$0.060     | \$0.065          | \$0.070         |

<Note>
  الجمع بين لوحات المزاج **و** مراجع الأسلوب لا يزيد سعر التوليد — تدفع سعر لوحة المزاج (\$0.040 لـ Medium / \$0.070 لـ Large).
</Note>

## نقاط النهاية (Endpoints)

| المتغير    | نقطة النهاية                              |
| ---------- | ----------------------------------------- |
| **Medium** | `POST /generate/image/krea/krea-2/medium` |
| **Large**  | `POST /generate/image/krea/krea-2/large`  |

## البدء السريع

أرسل طلب توليد واستعلم عن النتيجة. تتطلب جميع الطلبات رمز Bearer — راجع [مفاتيح API والفوترة](/developers/api-keys-and-billing) إذا لم يكن لديك واحد بعد.

<CodeGroup>
  ```javascript Node.js theme={null}
  // 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={null}
  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 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_TOKEN"
  ```

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

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

  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={null}
  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_TOKEN")
  	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"])
  }
  ```
</CodeGroup>

<Tip>
  قد تستغرق عمليات توليد Krea 2 Large وقتًا أطول لاكتمالها، لذا في أحمال العمل الإنتاجية يُفضَّل استخدام ترويسة [`X-Webhook-URL`](/developers/webhooks) بدلًا من الاستعلام المتكرر.
</Tip>

## المعاملات

يقبل `krea-2/medium` و`krea-2/large` نفس بنية الطلب العامة.

| الحقل                    | النوع   | ملاحظات                                                                                                      |
| ------------------------ | ------- | ------------------------------------------------------------------------------------------------------------ |
| `prompt`                 | string  | **مطلوب.** موجِّه نصي يصف الصورة.                                                                            |
| `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) + الموجِّه لإعادة إنتاج التوليد.                                           |
| `creativity`             | enum    | `raw`، `low`، `medium` (افتراضي)، `high`. انظر أدناه.                                                        |
| `image_style_references` | array   | اختياري. انظر [نقل الأسلوب](/developers/krea-2/style-transfer).                                              |
| `moodboards`             | array   | اختياري. انظر [لوحات المزاج](/developers/krea-2/moodboards). الحد الأقصى لوحة مزاج واحدة لكل طلب.            |
| `styles`                 | array   | أساليب مُدرَّبة اختيارية (LoRAs).                                                                            |
| `intensity`              | integer | اختياري. `-100` إلى `100`، الافتراضي `0`. انظر [المنزلقات التوليدية](/developers/krea-2/generative-sliders). |
| `complexity`             | integer | اختياري. `-100` إلى `100`، الافتراضي `0`. انظر [المنزلقات التوليدية](/developers/krea-2/generative-sliders). |
| `movement`               | integer | اختياري. `-100` إلى `100`، الافتراضي `0`. انظر [المنزلقات التوليدية](/developers/krea-2/generative-sliders). |

<h3 id="creativity">
  الإبداع
</h3>

يتحكم `creativity` في مدى توسُّع النموذج على ما كتبته. عندما يكون موجِّهك قصيرًا أو مبهمًا، يملأ النموذج القطع المفقودة — الأسلوب، التكوين، زاوية الكاميرا، لوحة الألوان — ويُقرِّر `creativity` مقدار الحرية التي يأخذها.

<AccordionGroup>
  <Accordion title="raw — بدون توسيع">
    يُصوِّر النموذج فقط ما وصفته صراحةً. الأفضل للموجِّهات الموجَّهة فنيًا بدقة حيث تكون كل تفصيلة محددة سلفًا.
  </Accordion>

  <Accordion title="low — قريب من الموجِّه">
    توسيع طفيف. يلتزم النموذج بالموجِّه الحرفي لكنه يملأ الفجوات الواضحة.
  </Accordion>

  <Accordion title="medium — متوازن (افتراضي)">
    السلوك الافتراضي. يضيف النموذج تفسيرًا معقولًا دون الابتعاد عن مقصد الموجِّه.
  </Accordion>

  <Accordion title="high — تفسير معبِّر">
    توسيع قوي. يأخذ النموذج حريات إبداعية ذات معنى في الأسلوب والمزاج والجماليات — الأفضل للموجِّهات القصيرة أو المفتوحة عندما تريد أن يفاجئك النموذج.
  </Accordion>
</AccordionGroup>

## استعراضات تفصيلية للميزات

<CardGroup cols={2}>
  <Card title="نقل الأسلوب" icon="palette" href="/developers/krea-2/style-transfer">
    استخرج أسلوب صورة مرجعية واحدة أو عدة صور وطبِّقه على مخرجاتك بقوة قابلة للضبط.
  </Card>

  <Card title="لوحات المزاج" icon="grid-2" href="/developers/krea-2/moodboards">
    أَشِر إلى لوحة مزاج Krea لتحديد الاتجاه البصري العام — اللوحة اللونية والنسيج والمزاج والتكوين.
  </Card>

  <Card title="المنزلقات التوليدية" icon="sliders" href="/developers/krea-2/generative-sliders">
    وجِّه الشدة والتعقيد والحركة في كل عملية توليد دون إعادة كتابة موجِّهك.
  </Card>
</CardGroup>

## مفتوح المصدر

Krea 2 متاح أيضًا كإصدار مفتوح المصدر إذا كنت تفضّل استضافة النموذج ذاتيًا أو ضبطه بدقة بدلاً من استدعاء واجهة API المُستضافة (أو بالتوازي معها). نُشرت نقطتا فحص على Hugging Face:

* **Krea 2 RAW** — نقطة الفحص الأساسية غير المُقطَّرة. متنوعة وقابلة للتشكيل، مُخصَّصة للضبط الدقيق وللتدريب اللاحق ولتدريب LoRA.
* **Krea 2 Turbo** — نقطة فحص مُقطَّرة من 8 خطوات، مبنية لاستدلال سريع من النص إلى الصورة. صُمِّمت LoRAs المُدرَّبة على 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)  |

### الترخيص

يصدر الإصدار مفتوح المصدر ضمن مسارَي ترخيص:

* **[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](/developers/api-keys-and-billing) القياسية — لست بحاجة إلى قبول رخصة المصدر المفتوح لاستدعاء `krea-2/medium` أو `krea-2/large`.
</Note>

## مرجع API

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 hidden dark:grid">
  <ModelOverviewCard name="Krea 2 Medium" href="/api-reference/krea/krea-2-medium" icon="/images/logo/krea-logo-icon-dark.svg" description="أسرع وأرخص وثابت عبر الرسوم التوضيحية والأنمي والأساليب التعبيرية." />

  <ModelOverviewCard name="Krea 2 Large" href="/api-reference/krea/krea-2-large" icon="/images/logo/krea-logo-icon-dark.svg" description="أكثر قوة — واقعية فوتوغرافية ونسيج خام ومخرجات أكثر مرونة." />
</div>

<div className="grid grid-cols-1 md:grid-cols-2 gap-4 block dark:hidden">
  <ModelOverviewCard name="Krea 2 Medium" href="/api-reference/krea/krea-2-medium" icon="/images/logo/krea-logo-icon-light.svg" description="أسرع وأرخص وثابت عبر الرسوم التوضيحية والأنمي والأساليب التعبيرية." />

  <ModelOverviewCard name="Krea 2 Large" href="/api-reference/krea/krea-2-large" icon="/images/logo/krea-logo-icon-light.svg" description="أكثر قوة — واقعية فوتوغرافية ونسيج خام ومخرجات أكثر مرونة." />
</div>