المصادقة والحساب
تعرف على كيفية إنشاء حساب وإدارة مفاتيح واجهة برمجة التطبيقات والمصادقة على طلباتك.
إعداد الحساب
يستغرق بدء استخدام Api.Airforce بضع خطوات فقط:
إنشاء حساب
قم بزيارة صفحة الاشتراك وقم بإنشاء حساب مجاني باسم مستخدم وكلمة مرور. لا يلزم وجود بريد إلكتروني أو بطاقة ائتمان للبدء.
احصل على مفتاح API الخاص بك
بعد تسجيل الدخول انتقل إلى لوحة التحكم. يتم إنشاء مفتاح واجهة برمجة التطبيقات الأساسي (الذي يسبقه sk-air-) تلقائيًا ويصبح جاهزًا للاستخدام.
قم بتقديم طلبك الأول
استخدم مفتاح API الخاص بك في رأس التفويض لمصادقة الطلبات إلى أي نقطة نهاية.
إدارة مفاتيح API
إدارة مفاتيح API الخاصة بك من لوحة المعلومات. تستخدم جميع المفاتيح البادئة sk-air-.
مفتاح واجهة برمجة التطبيقات الأساسي
يحصل كل حساب على مفتاح أساسي مع حق الوصول الكامل. لا يمكن حذف هذا المفتاح ولكن يمكن إعادة إنشائه من لوحة المعلومات.
sk-air-YOUR-KEYمفاتيح API الثانوية
قم بإنشاء مفاتيح إضافية ذات حدود مخصصة لتطبيقات مختلفة:
- قم بتعيين حدود RPM (الطلبات في الدقيقة) المخصصة لكل مفتاح
- قم بتعيين بدل الائتمان للحد الأقصى للإنفاق لكل مفتاح
- مفاتيح التسمية لسهولة التعرف والإدارة
طرق المصادقة
قم بتضمين مفتاح API الخاص بك في رأس التفويض كرمز مميز لحامل:
Bearer Token (Recommended)
curl https://api.airforce/v1/chat/completions \
-H "Authorization: Bearer sk-air-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4.1-mini",
"messages": [{"role": "user", "content": "Hello!"}]
}'Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://api.airforce/v1",
api_key="sk-air-YOUR_API_KEY"
)
response = client.chat.completions.create(
model="gpt-4.1-mini",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)Node.js
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.airforce/v1',
apiKey: 'sk-air-YOUR_API_KEY',
});
const response = await client.chat.completions.create({
model: 'gpt-4.1-mini',
messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);إشعار أمني
لا تشارك مطلقًا مفتاح API الخاص بك علنًا، أو تلزمه بالتحكم في الإصدار، أو تعرضه في تعليمات برمجية من جانب العميل. التعامل معها مثل كلمة المرور. إذا تم اختراق مفتاحك، فأعد إنشائه على الفور من لوحة المعلومات.