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

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

هناك نوعان من رموز API:
  • رموز API الشخصية تعمل باسمك أنت: تُنفَّذ الطلبات ضمن حسابك الخاص على Krea، بدورك في مساحة العمل وبإمكانية الوصول إلى أنماطك. يستطيع أي عضو في مساحة العمل إنشاء رمز شخصي، ويتوقف الرمز الشخصي عن العمل إذا غادرت مساحة العمل.
  • رموز API الخدمية تعمل باسم مستخدم خدمة منفصل في مساحة عملك، وليس باسم الشخص الذي أنشأها. يستطيع المالكون والمشرفون على مساحة العمل فقط إنشاءها. تستمر الرموز الخدمية في العمل إذا غادر منشئها مساحة العمل. يستطيع المالكون والمشرفون على مساحة العمل رؤية جميع الرموز في مساحة العمل، مع تتبّع الإنفاق لمدة 30 يومًا لكل رمز خدمي.
لإنشاء مفتاح API:
  1. انتقل إلى krea.ai/app/api/tokens
  2. انقر على Create Personal Token أو Create Service Token
  3. أعطِ مفتاحك اسمًا وصفيًا
  4. احفظ الرمز بأمان — ستراه مرة واحدة فقط!
تعمل رموز API الشخصية بحسابك الخاص على Krea، لذا تكون الأنماط التي درّبتها في التطبيق متاحةً لها مباشرةً. أما رموز API الخدمية فتعمل بهوية مستخدم منفصلة داخل مساحة عملك: لن تكون الأنماط المدرَّبة في التطبيق متاحةً عبر رمز خدمي، ولن تظهر الأنماط المدرَّبة عبر رمز خدمي في التطبيق، ما لم تتم مشاركتها مع مساحة العمل. راجع تدريب نمط مخصص للتفاصيل.
إرشادات الأمان
  • خزّن الرموز في متغيرات البيئة، وليس في الشيفرة أبدًا
  • استخدم رموزًا مختلفة للتطوير والإنتاج
  • ألغِ الرموز فورًا في حال تسربها
  • لا تُودع الرموز أبدًا في نظام التحكم بالإصدارات
  • لا تُشارك الرموز علنًا أبدًا

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

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

التسعير

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

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

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

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

تكتمل المهام الجارية بشكل طبيعي. تُرفض طلبات API الجديدة بـ HTTP 402 Payment Required:
أعد شحن الرصيد عبر krea.ai/app/api/ للاستئناف. لا توجد نقطة نهاية عامة للتحقق من رصيدك برمجيًا — راقبه من داخل التطبيق. نص الاستجابة هذا هو استجابة 402 الخاصة برصيد API. أما استجابة Zero Data Retention واستجابات 402 الأخرى فمُدرجة في الأخطاء وتصحيحها.

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

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

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

راجع صفحة استخدام API على krea.ai/app/api/usage للاطلاع على مهام API المكتملة والتكاليف التقديرية خلال نطاق زمني قابل للتحديد. يرى مديرو مساحة العمل الاستخدام لمساحة العمل بأكملها؛ بينما يرى الأعضاء الآخرون الاستخدام الناتج عن رموزهم الخاصة. كما تعرض بطاقة رصيد API على krea.ai/app/api/ تكلفة API التقديرية لآخر 7 أيام.

المؤسسات

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

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

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

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

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

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

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

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

حدود المعدل

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