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

# API Keys & Billing

> أنشئ مفاتيح API وأدرها، وأعد شحن رصيد API الخاص بك، وافهم التسعير لكل نموذج لتتمكن من إطلاق تكاملات Krea بتكاليف يمكن التنبؤ بها.

## إنشاء مفاتيح API

يستطيع **المالكون** و**المشرفون** على مساحة العمل فقط إنشاء رموز API. إذا لم يظهر لك خيار إنشاء رمز، فتواصل مع مالك مساحة العمل لطلب الوصول أو الحصول على دور أعلى.

لإنشاء مفتاح API:

1. انتقل إلى [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens)
2. تأكد من أنك في مساحة العمل الصحيحة (باستخدام مبدّل مساحة العمل في أعلى اليسار)
3. انقر على "New Token"
4. أعطِ رمزك اسمًا وصفيًا
5. احفظ الرمز بأمان — ستراه مرة واحدة فقط!

<Info>
  تعمل واجهة API بهوية مستخدم خاصة بها داخل مساحة عملك. لن تكون الأنماط المدرَّبة في التطبيق متاحةً عبر API، ولن تظهر الأنماط المدرَّبة عبر API في التطبيق، ما لم تتم مشاركتها مع مساحة العمل. راجع [تدريب نمط مخصص](/developers/tutorials/train-image-style#use-your-trained-style) للتفاصيل.
</Info>

<Warning>
  **إرشادات الأمان**

  * خزّن الرموز في متغيرات البيئة، وليس في الشيفرة أبدًا
  * استخدم رموزًا مختلفة للتطوير والإنتاج
  * ألغِ الرموز فورًا في حال تسربها
  * لا تُودع الرموز أبدًا في نظام التحكم بالإصدارات
  * لا تُشارك الرموز علنًا أبدًا
</Warning>

## استخدام مفاتيح API

ضمّن رمزك في ترويسة `Authorization` في جميع الطلبات:

<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 job = await krea.image("bfl/flux-1-dev", {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576
  });

  console.log(`Job ID: ${job.job_id}`);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.krea.ai/generate/image/bfl/flux-1-dev \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "a serene mountain landscape at sunset",
      "width": 1024,
      "height": 576
    }'
  ```

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

  API_BASE = "https://api.krea.ai"
  API_TOKEN = "your-api-token"

  response = requests.post(
      f"{API_BASE}/generate/image/bfl/flux-1-dev",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json"
      },
      json={
          "prompt": "a serene mountain landscape at sunset",
          "width": 1024,
          "height": 576
      }
  )

  job = response.json()
  print(f"Job ID: {job['job_id']}")
  ```

  ```go Go theme={null}
  package main

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

  func main() {
      apiBase := "https://api.krea.ai"
      apiToken := "your-api-token"

      payload := map[string]interface{}{
          "prompt": "a serene mountain landscape at sunset",
          "width":  1024,
          "height": 576,
      }

      jsonData, _ := json.Marshal(payload)
      req, _ := http.NewRequest("POST", apiBase+"/generate/image/bfl/flux-1-dev", bytes.NewBuffer(jsonData))
      req.Header.Set("Authorization", "Bearer "+apiToken)
      req.Header.Set("Content-Type", "application/json")

      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()

      var job map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&job)
      fmt.Printf("Job ID: %s\n", job["job_id"])
  }
  ```
</CodeGroup>

## التسعير

للاطلاع على الأسعار لكل نموذج، راجع [krea.ai/features/api ↗](https://krea.ai/features/api). لكل نموذج سعر ثابت لكل عملية توليد يُحدَّد بناءً على معاملات طلبك (الدقة، الجودة، الصوت، المدة، المراجع النمطية، إلخ).

## كيفية عمل فوترة API

تسحب استدعاءات API المباشرة واتصالات MCP التي تستخدم رمز API من **رصيد USD منفصل** على مساحة عملك — مستقل عن وحدات الحوسبة التي يستخدمها تطبيق Krea على الويب. أما اتصالات MCP التي تستخدم OAuth فتُفوتر على حساب Krea الذي سجلت الدخول إليه باستخدام وحدات الحوسبة. يجب تمكين الوصول إلى API على مساحة عملك قبل أن تتمكن من استخدام مفاتيح API؛ إذا لم يكن ممكَّنًا، فتواصل مع [support@krea.ai ↗](mailto:support@krea.ai).

<Check>
  لا تُحتسب رسوم على المهام الفاشلة أو الملغاة. أنت تدفع فقط مقابل المهام المكتملة.
</Check>

### عندما ينفد رصيدك

تكتمل المهام الجارية بشكل طبيعي. تُرفض طلبات API الجديدة بـ **HTTP 402 Payment Required**:

```json theme={null}
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
```

أعد شحن الرصيد عبر [krea.ai/app/api/](https://krea.ai/app/api/) للاستئناف. لا توجد نقطة نهاية عامة للتحقق من رصيدك برمجيًا — راقبه من داخل التطبيق.

## إضافة رصيد إلى API

أضف الأموال عبر [krea.ai/app/api/](https://krea.ai/app/api/). يستطيع **مالكو** مساحة العمل فقط إضافة رصيد API.

* **مبالغ محددة مسبقًا:** \$10، \$25، \$50، \$100
* **مبلغ مخصص:** \$5 كحد أدنى، \$10,000 كحد أقصى
* يُدفع عبر Stripe Checkout؛ يُطبَّق الرصيد فورًا عند النجاح

## تتبع الاستخدام

يظهر الإنفاق الأخير في بطاقة رصيد API على [krea.ai/app/api/](https://krea.ai/app/api/) تحت "API cost in the last 7 days".

## المؤسسات

<Info>
  يمكن فوترة العملاء ذوي الأحجام الأعلى شهريًا بشروط Net 30 بدلًا من الدفع المسبق. تواصل مع [sales@krea.ai ↗](mailto:sales@krea.ai) لمناقشة فوترة المؤسسات.
</Info>

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="بيئة تجريبية تفاعلية" icon="rocket" href="/developers/interactiveexample">
    أنشئ أول طلب API لك
  </Card>

  <Card title="واجهات برمجة النماذج" icon="book-open" href="/api-reference/image/flux">
    استكشف جميع نقاط النهاية المتاحة
  </Card>

  <Card title="دورة حياة المهمة" icon="cube" href="/developers/job-lifecycle">
    افهم حالات المهام والاستعلام عنها
  </Card>

  <Card title="حدود المعدل" icon="gauge" href="/developers/rate-limits">
    افهم حدود API حسب مستوى الخطة
  </Card>
</CardGroup>