اختبار مفتاح API للذكاء الاصطناعي: تحقق من المفتاح في 30 ثانية

لماذا تختبر محلياً بدلاً من صفحة ويب

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

تحتاج إلى ثلاثة أشياء: المفتاح، ونقطة النهاية https://api.getaiapikey.com/v1، ومعرف النموذج uncensored. ضع المفتاح في متغير بيئة حتى لا ينتهي بك الأمر في سجل الـ shell أو في ملف قد تقوم بإدراجه.

Copyexport API_KEY="paste-your-key-here"

تُستخرج المفاتيح من صفحة مفتاح API. إذا لم يكن لديك مفتاح بعد، يمكن للمستخدمين الجدد الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة بعد تسجيل الحساب، وهو كافٍ لإجراء كل الاختبارات في هذا المقال مراراً وتكراراً.

الفحص 1: سرد النماذج باستخدام curl

أرخص اختبار هو قائمة النماذج. يتطلب مفتاحاً صالحاً ونقطة نهاية صحيحة، ولا يولّد أي نص.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

يُطبع العلم -i رؤوس الاستجابة. يبدأ الرد السليم بـ HTTP/2 200 وجسم JSON يتضمن معرف النموذج uncensored. إذا رأيت خطأ مصادقة (عادةً الحالة 401)، فالمفتاح غير صحيح، أو تم نسخه مع مسافة في النهاية، أو أن الرأس يفتقد كلمة Bearer. تعني الحالة 404 أن URL غير صحيح، وغالباً بسبب فقدان /v1 أو وجوده مرتين.

الفحص 2: تشغيل إكمال حقيقي واحد

قد يكون المفتاح صالحاً لكنه يفشل في طلب حقيقي، مثلاً بسبب فراغ الرصيد. لذا أرسل استدعاء دردشة صغيراً وحدّ الإخراج للحفاظ على التكلفة قريبة من الصفر:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

اقرأ الرؤوس قبل الجسم. يُعرّف X-Request-Id المكالمة، وهو ما تطلبه الدعم. يُظهر X-Balance-USD مقدار الرصيد المتبقي. يكشف X-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency حدود مفتاحك: 300 و8 للمفتاح الكامل، و60 و2 للمفتاح التجريبي. لذلك يتحقق هذا الطلب من المصادقة، والنموذج، والرصيد، ونوع المفتاح.

سعر الاختبار ضئيل. موجّه بحوالي 10 رموز (token) ورد بحوالي 5 رموز (token) يكلف 10 × $0.15 / 1M + 5 × $0.50 / 1M، أي حوالي $0.000004. الطلبات الفاشلة أو المرفوضة لا تُحسب مطلقاً.

الفحص 3: نفس الاختبار في Python

إذا كان كودك الحقيقي يستخدم Python، فاختبره بالطريقة التي سيعمل بها الكود. يستخدم هذا السكربت الحزمة الرسمية openai، لذا فإن نجاحها يعني أن إعداد تطبيقك يعمل أيضاً:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

يوفر الغلاف الوظيفي with_raw_response الوصول إلى الرؤوس بينما يعيد parse() كائن الاستجابة المعتاد. إذا فشل الاستيراد، فإعداد Python نفسه مغطى في كيفية تثبيت عميل LLM في Python.

تحقق من رصيدك دون إكمال

لقراءة الرصيد دون توليد نص، اتصل بإحدى نقاط نهاية الرصيد. هناك نسخة بأسلوب OpenAI ونسخة مختصرة:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

الأدوات التي تتوقع بالفعل تنسيق منح رصيد OpenAI يمكنها استخدام المسار الثاني دون تغيير. أضف استدعاءً مثل هذا إلى برنامج نصي للمراقبة وستحصل على تحذير قبل أن ينفد رصيد الروبوت الإنتاجي. تبدأ شحنات الرصيد من $20 ولا ينتهي الرصيد، لذا لا توجد غرامة للاحتفاظ باحتياطي مريح. المبالغ والمكافآت موجودة في صفحة الأسعار.

حوّل الاختبار إلى فحص صحة

بمجرد أن يعمل المفتاح، استمر في الاختبار. برنامج نصي صغير يعمل وفق جدول زمني يُعلمك عن فشل النشر، أو انتهاء صلاحية المفتاح السري، أو انخفاض الرصيد قبل أن يلاحظه مستخدموك. إليك نسخة Node.js باستخدام fetch المدمج (Node 18 أو أحدث):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

ينتهي السكربت برمز خروج غير صفري عند فشل المكالمة أو انخفاض الرصيد عن $5، لذا يمكن لجدول cron أو خطوة CI تنبيهك. اختر العتبة من معدل استهلاكك الخاص: عند $2 يومياً، يمنحك $5 تحذيراً لأكثر من يومين.

ما لا يثبته الاختبار الناجح

علامة الصح الخضراء تظهر أن المصادقة، والتوجيه، والنموذج يعملان في تلك اللحظة، عند حمل منخفض. لا تظهر كيف يتصرف تطبيقك مع 20 مستخدماً في آن واحد. لذلك، تذكر الحدود: يعمل المفتاح الكامل على 8 طلبات في نفس الوقت، وتحافظ الطلبات المتدفقة على شغلتها حتى ينتهي البث المتدفق. اختبر حمل كودك الخاص بحدّ على الطلبات المتزامنة قبل الإطلاق.

قراءة الأخطاء

ما تراه	السبب الأكثر احتمالاً	الإجراء المطلوب
خطأ مصادقة، غالباً 401	مفتاح خاطئ، مسافات زائدة، عدم وجود بادئة Bearer	أعد نسخ المفتاح، تحقق من سلسلة الرأس
404 أو HTML بدلاً من JSON	عنوان URL الأساسي غير صحيح	استخدم بالضبط https://api.getaiapikey.com/v1
النموذج غير موجود	معرف نموذج مختلف في الطلب	عيّن model إلى uncensored
خطأ 429 مع rate_limited أو concurrency	طلبات كثيرة جداً في الدقيقة أو في وقت واحد	انتظر، ثم أعد المحاولة مع تأخير
429 مع Retry-After: 5	إجهاد مؤقت	انتظر 5 ثوانٍ وأعد المحاولة
خطأ في الاتصال أو انتهاء المهلة	الشبكة، أو الوكيل، أو جدار الحماية	اختبر من شبكة أخرى، وتحقق من متغيرات الوكيل

يتم رفض الطلبات التي يتجاوز حجمها 8 MB، لذا إذا كانت المكالمات الكبيرة فقط هي التي تفشل، فافحص حجم محتوى الطلب. تُدرج الوثائق جميع رموز الخطأ وعلامات الرأس.

عادات جيدة للتعامل مع المفتاح

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

إذا كنت تريد فقط معرفة ما إذا كان خيار مجاني موجوداً قبل أن تقوم بتسجيل الحساب، فإن المقال حول مفتاح API LLM مجاني يوضح ما هو متاح. وإلا، فإن الفحوصات الثلاث المذكورة أعلاه هي كل ما يحتاجه المفتاح للاختبار.

المزيد من الأدلة

• أسعار مفتاح API للذكاء الاصطناعي: التكلفة الحقيقية لمفتاح واحد
• قائمة مراجعة واجهة برمجة API للذكاء الاصطناعي