المفاتيح وعنوان API

من أين تحصل على المفتاح، والعنوان المستخدم في حزم SDK المختلفة، وكيفية إرسال المفتاح.

الدليل الكامل

مفتاح API

يُنشأ المفتاح في لوحة الحساب على ailoot.ai بعد إنشاء الحساب. ويكون بصيغة sk-…. يمكنك إنشاء عدة مفاتيح: للكمبيوتر المستخدم للعمل، وللخادم، ولكل تطبيق؛ يسهل ذلك إبطال مفتاح واحد دون التأثير في البقية.

يمكن تحديد حد إنفاق إجمالي وصلاحية وقوائم IP مسموحة ومحظورة، وحدود إنفاق لنوافذ 5 ساعات ويوم واحد و7 أيام. عند تفعيل قيد، يأتي خطأ مفهوم: api_key_quota_exhausted (استُنفد الحد الإجمالي)، usage_limit_reached (استُنفدت نافذة إنفاق المفتاح؛ انتظر تحديثها أوارفع الحد)، api_key_expired أو permission_denied (مثلاً، أُرسل الطلب من IP غير مسموح به).

عنوان API

القاعدة الأساسية: عنوان العملاء المتوافقين مع OpenAI يتضمن /v1، وعنوان Anthropic وGemini لا يتضمنها.

العميل	العنوان الأساسي	وجهة الطلب
OpenAI SDK والعملاء المتوافقون	`https://api.ailoot.ai/v1`	`/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`
Anthropic SDK, Claude Code	`https://api.ailoot.ai`	`/v1/messages`
Google GenAI SDK, Gemini CLI	`https://api.ailoot.ai`	`/v1beta/models/{model}:generateContent`
العميل يطلب العنوان الكامل	`https://api.ailoot.ai/v1/chat/completions`	كما هو محدد

كيفية إرسال المفتاح

يقبل Ailoot المفتاح في أي من الترويسات الثلاث؛ وتناسبه الترويسة التي ترسلها SDK:

الترويسة	من يرسل بهذه الطريقة
`Authorization: Bearer sk-…`	OpenAI SDK ومعظم العملاء
`x-api-key: sk-…`	Anthropic SDK وClaude Code مع ANTHROPIC_API_KEY
`x-goog-api-key: sk-…`	Google GenAI SDK, Gemini CLI

على المسارات /v1/… لا يُقبل المفتاح في العنوان (?key= أو ?api_key=)؛ يتلقى الطلب 400 بالرمز invalid_request ورسالة توضح إرسال المفتاح في العنوان. يمنع ذلك ظهوره في السجلات وسجل المتصفح. إذا استُخدم المفتاح في العنوان بالفعل، يُفضّل إنشاء مفتاح جديد.

على مسارات Gemini /v1beta/… يُقبل للتوافق مع Google ?key= — بأدنى أولوية، بعد الترويسات. ?api_key= يُرفض هناك أيضاً بالرمز 400. يظل إرسال المفتاح في الترويسة أكثر موثوقية x-goog-api-key.

متغيرات البيئة

من الملائم إنشاء متغير واحد واستخدامه في إعدادات برامج مختلفة:

# ~/.zshrc أو ~/.bashrc
export AILOOT_API_KEY="sk-..."

# للبرامج التي تقرأ الأسماء القياسية
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"

setx AILOOT_API_KEY "sk-..."

# للبرامج التي تقرأ الأسماء القياسية
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# أعد تشغيل الطرفية لتُحمَّل المتغيرات

التحقق من المفتاح

أرخص طريقة للتحقق من المفتاح هي طلب قائمة النماذج؛ فهذا مجاني.

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.مراسلة الدعم