المصادقة

تتم مصادقة كل طلب إلى نقطة نهاية مدفوعة بمفتاح API من api14، يُرسَل كـ Bearer token في ترويسة Authorization.

Authorization: Bearer sk-api14-...

تضبط حِزم OpenAI SDK هذه الترويسة نيابةً عنك من الخيار apiKey / api_key.

مفاتيح API

أنشئ مفاتيحك وأدِرها من مفاتيح API.

• تبدأ المفاتيح بـ sk-api14- وتُعرض مرة واحدة فقط عند إنشائها. لا نخزّن سوى قيمة hash، لذا لا يمكن استرجاع مفتاح مفقود، أنشئ مفتاحًا جديدًا وألغِ القديم.
• يمكن لكل مفتاح أن يملك حدًّا خاصًا للطلبات في الدقيقة وحدًّا يوميًا للإنفاق بالدولار وقائمة نماذج مسموح بها. راجع حدود المعدّل.
• يعتمد عدد المفاتيح التي يمكنك امتلاكها على خطتك: 1 في Free، و10 في Pro، وأكثر في Team وEnterprise.
• يسري إلغاء المفتاح فورًا؛ وتُعيد الطلبات التي تستخدمه 401 invalid_api_key.

استخدام المفتاح

احفظ المفتاح في متغيّر بيئة واقرأه من الكود:

export API14_API_KEY="sk-api14-..."

curl https://api14.com/api/v1/chat/completions \
  -H "Authorization: Bearer $API14_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

نقاط نهاية لا تتطلب مفتاحًا

تعمل نقاط نهاية الكتالوج التالية، وهي للقراءة فقط، دون مصادقة:

أما كل ما عدا ذلك، نقاط نهاية التوليد و/credits و/key و/generation وحالة مهام الفيديو، فيتطلب مفتاحًا.

أخطاء المصادقة

يؤدي المفتاح المفقود أو غير الصالح الصيغة أو الملغى إلى إرجاع:

{
  "error": {
    "message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

مع رمز حالة HTTP 401. أما المفتاح المقيّد بقائمة نماذج مسموح بها فيُعيد 403 model_not_allowed للنماذج الأخرى. راجع الأخطاء.

الحفاظ على أمان المفاتيح

• لا تضع المفتاح أبدًا في كود المتصفح أو تطبيقات الجوال، إذ يستطيع أي شخص قراءته هناك. استدعِ api14 من الخادم الخاص بك.
• لا ترفع المفاتيح أبدًا إلى نظام التحكم في الإصدارات. استخدم متغيّرات البيئة أو مدير أسرار.
• استخدم مفتاحًا لكل تطبيق أو بيئة، لتتمكن من إلغاء أحدها دون تعطيل البقية.
• اضبط حدًّا يوميًا بالدولار على المفاتيح التي تستخدمها السكربتات أو الخدمات الأقل موثوقية، حتى لا يستنزف خطأٌ برمجي رصيدك.
• إذا تسرّب مفتاح، فألغِه فورًا من مفاتيح API.