AR ▾

واجهة برمجة تطبيقات LLM بدون رقابة متوافقة مع OpenAIuncensoredapis.com

الرئيسيةالوكلاء

تجربة مجانية لواجهة برمجة تطبيقات LLM: ما الذي يجب اختباره في الساعة الأولى

أزرار قائمة تحقق متصلة بمكعب خادم وعملات، تمثل خطة اختبار تجربة واجهة برمجة التطبيقات في الساعة الأولى

تجربة API مجانية للـ LLM قصيرة ومحدودة، لذا الهدف هو التعلم بسرعة لمعرفة ما إذا كانت نقطة النهاية تناسب مشروعك. يغطي هذا الدليل ما يجب اختباره في الساعة الأولى ومدى امتداد رصيد $0.50.

تم التحديث

نقاط رئيسية

  1. تبلغ قيمة التجربة $0.50، تُستلم بنقرة واحدة في صفحة مفتاح API، صالحة لمدة 7 أيام، بدون بطاقة.
  2. اختبر بهذا الترتيب: قائمة النماذج، الدردشة العادية، البث المتدفق، استدعاء الدوال، وضع JSON، الحدود.
  3. مفاتيح التجربة تسمح بـ 2 طلب متزامن و60 طلبًا في الدقيقة.
  4. $0.50 تغطي حوالي 900 طلبًا بحجم 2,000 رمز مدخل و500 رمز مخرج.

ما يمنحك رصيد التجربة

يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد التجربة بعد التسجيل. تسجّل باستخدام Google أو بالبريد الإلكتروني وكلمة المرور، تفتح صفحة مفتاح API وتضغط على زر واحد. لا توجد بطاقة لإدخالها، والرصيد صالح لمدة 7 أيام، وتجربة واحدة لكل شخص.

الـ API متوافق مع OpenAI، لذا فإن أي شيء يتواصل مع SDK الخاص بـ OpenAI سيعمل بعد تغيير Base URL والمفتاح. معرف النموذج هو دائمًا uncensored. إنه نموذج واحد مفتوح الأوزان يديره مزود مستقل ومضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين، مع نافذة سياق بحجم 100,000 رمز. النص فقط: لا صور، صوت، تضمينات أو ضبط دقيق.

أيام سبعة كافية إذا خططت للعمل، ولا تكون التجربة مفيدة إلا إذا قمت بتشغيل موجّهات حقيقية فعليًا. لا تختبر بـ "hello world" فقط؛ استخدم نوع الإدخال الذي سيرسله منتجك، بما في ذلك المستندات الطويلة، التنسيق الغريب والمواضيع التي تهم مستخدميك. خصص الساعة الأولى للتحقق مما يلي، ثم قرر ما إذا كنت ستقوم بـ شحن الرصيد من $20 أو تترك الأمر.

الخطوة 1: إنشاء المفتاح وقائمة النماذج

انتقل إلى صفحة مفتاح API، أنشئ مفتاحًا واستلم التجربة. احفظ المفتاح في متغير بيئة بدلاً من الكود.

export API_KEY="sk-your-key"
curl -s https://api.uncensoredapis.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

قائمة JSON التي تحتوي على uncensored تثبت ثلاثة أشياء في آن واحد: أن نقطة النهاية صحيحة، وأن المفتاح مقبول، وأن مصادقة Bearer تعمل. إذا حصلت على 401، فالمفتاح غير صحيح أو يحتوي على فراغ زائد. يشرح دليل مرجع API حقول الاستجابة.

الخطوة 2: إرسال طلب دردشة عادي

قبل أي ميزة متقدمة، تحقق من المسار الأساسي واقرأ رؤوس الاستجابة. أضف -i إلى curl لعرضها.

curl -i https://api.uncensoredapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Explain DNS in two sentences."}]
  }'

ابحث عن X-Request-Id (احتفظ به إذا تواصلت مع الدعم الفني)، وX-Balance-USD (رصيدك المتبقي بعد المكالمة)، والرأسين X-RateLimit-Limit-*. نفذ الطلب نفسه مرتين وراقب انخفاض الرصيد بمقدار ضئيل. هذا يؤكد أن الفوترة تعمل كما تتوقع. max_tokens اختياري، لذا لا تحتاجه لهذا الاختبار.

الخطوة 3: اختبار البث المتدفق

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

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredapis.com/v1", api_key="sk-your-key")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about servers."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\nusage:", chunk.usage)

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

الخطوة 4: استدعاء الدوال ووضع JSON

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

استدعاء الدوال

tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up an order by its ID",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    },
}]
resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Where is order A-1042?"}],
    tools=tools,
)
print(resp.choices[0].message.tool_calls)

تحقق من أن الحجج تُحلل كـ JSON وتتطابق مع مخططك. ثم أرسل النتيجة كرسالة مع role: "tool" وتأكد من أن النموذج يجيب بناءً عليها. يوضح صفحة الوكلاء واستدعاء الدوال الحلقة الكاملة.

وضع JSON

مرر response_format={"type": "json_object"} واكتب كلمة JSON في الموجّه. نفذ عشرة مدخلات متنوعة وحلل كل رد باستخدام json.loads. فشل واحد من كل عشرة يخبرك بإضافة التحقق من الصحة وإعادة المحاولة في الكود الخاص بك.

الخطوة 5: اختبار الحدود عمدًا

يتيح مفتاح التجربة طلبين متزامنين و60 طلبًا في الدقيقة. يمنحك المفتاح الكامل 8 و300. تجاوز حدًا وتعيد الـ API استجابة HTTP 429، مع رمز الخطأ rate_limited للطلبات في الدقيقة أو concurrency للكثرة في آن واحد. الحمل الزائد المؤقت يعطي أيضًا 429، مع رأس Retry-After: 5.

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

مشاكل التجربة الشائعة وحلولها

  • 401 في كل مكالمة: المفتاح يحتوي على فراغ زائد أو سطر جديد، أو أن الرأس ليس Authorization: Bearer .... اطبع طول الرأس في الكود الخاص بك لاكتشاف ذلك.
  • 404: يفتقر Base URL إلى /v1، أو أن SDK يضيف المسار مرتين. استخدم Base URL بالضبط كما هو مكتوب في هذا المقال.
  • 429 أثناء اختبار قصير: تسمح مفاتيح التجربة بطلبين فقط في وقت واحد. نفذ الاختبارات بالتسلسل، أو أضف قفلًا بسيطًا (semaphore) حول مكالماتك.
  • الرصيد لا يتغير: اقرأ X-Balance-USD من الاستجابة الخام، وليس من قيمة مخزنة مؤقتًا. كل مكالمة تكلف جزءًا من سنت، لذا قارن بأربع منازل عشرية.
  • الإجابات المقطوعة: تحقق من finish_reason. إذا كان يشير إلى length، فهذا يعني أنك حددت قيمة max_tokens منخفضة. هذا الإعداد اختياري، ويمكن أن يستكمل النموذج باستخدام باقي نافذة الـ 100,000 رمز.

احتفظ بسجل قصير لما قمت بتشغيله وما رأيته. بعد الساعة، يجب أن تكون قادرًا على الإجابة بنعم أو لا على ثلاث أسئلة: هل يتصرف الـ API مثل OpenAI حيث يحتاج الكود، هل يجيب النموذج على نوع الموجّهات الخاصة بي دون رفض، وهل يتناسب التكلفة لكل مهمة مع ميزانيتك؟ إذا كانت الإجابة نعم على الثلاثة، قم بشحن الرصيد. إذا لم يكن كذلك، لم تخسر شيئًا سوى بضعة سنتات من رصيد التجربة.

مدى وصول قيمة $0.50

الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. ثلاثة أحمال عمل نموذجية:

طلبالتكلفة لكل استدعاءتكاليف المكالمات تبدأ من $0.50
1,000 إدخال، 500 إخراج$0.00015 + $0.00025 = $0.00041,250
2,000 إدخال، 500 إخراج$0.0003 + $0.00025 = $0.00055حوالي 909
50,000 إدخال، 1,000 إخراج$0.0075 + $0.0005 = $0.00862

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

أسئلة وأجوبة

هل أحتاج إلى بطاقة للاستفادة من التجربة؟

لا. سجّل باستخدام Google أو البريد الإلكتروني وكلمة المرور، ثم استلم مبلغ $0.50 بنقرة واحدة في صفحة مفتاح API.

ماذا يحدث بعد 7 أيام؟

ينتهي رصيد التجربة غير المستخدم. يبقى حسابك، ويمكنك شحن أي مبلغ صحيح (عدد صحيح) من $20 إلى $500 للمتابعة.

هل يمكنني الحصول على التجربة أكثر من مرة؟

لا، هو واحد لكل شخص.

هل يستهلك الطلب الفاشل رصيد التجربة؟

لا. الطلبات الفاشلة أو المرفوضة لا يتم خصم تكلفتها.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.