الانتقال إلى المحتوى الرئيسي

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

يستطيع المالكون والمشرفون على مساحة العمل فقط إنشاء رموز API. إذا لم يظهر لك خيار إنشاء رمز، فتواصل مع مالك مساحة العمل لطلب الوصول أو الحصول على دور أعلى. لإنشاء مفتاح API:
  1. انتقل إلى krea.ai/settings/api-tokens
  2. تأكد من أنك في مساحة العمل الصحيحة (باستخدام مبدّل مساحة العمل في أعلى اليسار)
  3. انقر على “New Token”
  4. أعطِ رمزك اسمًا وصفيًا
  5. احفظ الرمز بأمان — ستراه مرة واحدة فقط!
تعمل واجهة API بهوية مستخدم خاصة بها داخل مساحة عملك. لن تكون الأنماط المدرَّبة في التطبيق متاحةً عبر API، ولن تظهر الأنماط المدرَّبة عبر API في التطبيق، ما لم تتم مشاركتها مع مساحة العمل. راجع تدريب نمط مخصص للتفاصيل.
إرشادات الأمان
  • خزّن الرموز في متغيرات البيئة، وليس في الشيفرة أبدًا
  • استخدم رموزًا مختلفة للتطوير والإنتاج
  • ألغِ الرموز فورًا في حال تسربها
  • لا تُودع الرموز أبدًا في نظام التحكم بالإصدارات
  • لا تُشارك الرموز علنًا أبدًا

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

ضمّن رمزك في ترويسة Authorization في جميع الطلبات: 
// 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}`);

​
التسعير

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

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

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

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

تكتمل المهام الجارية بشكل طبيعي. تُرفض طلبات API الجديدة بـ HTTP 402 Payment Required: 
{
  "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/ للاستئناف. لا توجد نقطة نهاية عامة للتحقق من رصيدك برمجيًا — راقبه من داخل التطبيق.

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

أضف الأموال عبر krea.ai/app/api/. يستطيع مالكو مساحة العمل فقط إضافة رصيد API.
  • مبالغ محددة مسبقًا: $10، $25، $50، $100
  • مبلغ مخصص: $5 كحد أدنى، $10,000 كحد أقصى
  • يُدفع عبر Stripe Checkout؛ يُطبَّق الرصيد فورًا عند النجاح

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

يظهر الإنفاق الأخير في بطاقة رصيد API على krea.ai/app/api/ تحت “API cost in the last 7 days”.

​
المؤسسات

يمكن فوترة العملاء ذوي الأحجام الأعلى شهريًا بشروط Net 30 بدلًا من الدفع المسبق. تواصل مع sales@krea.ai ↗ لمناقشة فوترة المؤسسات.

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

بيئة تجريبية تفاعلية

أنشئ أول طلب API لك

واجهات برمجة النماذج

استكشف جميع نقاط النهاية المتاحة

دورة حياة المهمة

افهم حالات المهام والاستعلام عنها

حدود المعدل

افهم حدود API حسب مستوى الخطة