AR ▾
احصل على مفتاح API
واجهة برمجة تطبيقات بدون رقابة متوافقة مع OpenAI للمطوّرين.تم التحديث

أمثلة cURL لواجهة LLM API يمكنك نسخها وتشغيلها

إذا كنت تريد اختبار واجهة برمجة LLM باستخدام cURL قبل كتابة أي كود، فإن الطلبات أدناه تكفي. يستهدف كل منها نقطة النهاية المتوافقة مع OpenAI، ويستخدم معرف النموذج uncensored، ويعمل من خلال طرفية عادية.

لوحة طرفية ترسل شعاع ضوء إلى مكعب خادم، مما يمثل طلب cURL إلى واجهة برمجة LLM

أعد إعداد بيئة سطر الأوامر وتحقق من نقطة النهاية

احصل على مفتاح من صفحة مفتاح API، ثم صدّره مع عنوان URL الأساسي حتى لا تلصق الأسرار في كل أمر.

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

يُرسل كل طلب المفتاح كرمز حامل (Bearer token) في رأس Authorization. تكون طلبات POST بصيغة JSON، لذا أضف Content-Type: application/json. الحد الأقصى لحجم الجسم هو 8 MB، وهو ما يهم فقط عند لصق مستندات كبيرة جدًا في الموجّه.

تستخدم الأمثلة علامات الاقتباس الفردية في بيئة Unix. في PowerShell على Windows، ضع JSON في ملف وتمرّره باستخدام --data @body.json لتجنب مشاكل الاقتباس.

أرخص فحص للتأكد من صحة الإعدادات هو طلب GET الذي يعرض النماذج. يؤكد ذلك صحة المفتاح وعنوان URL، ولا يكلف شيئًا.

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

يجب أن تتضمن مصفوفة data في الرد المعرّف uncensored. يعني الخطأ 401 أن المفتاح مفقود أو مكتوب بشكل خاطئ. إذا لم يتمكن curl من الاتصال مطلقًا، تحقق من المضيف في $BASE وتأكد من أنه ينتهي بـ /v1 بدون مسار إضافي.

1. إرسال إكمال محادثة

هذا هو الطلب الذي يرسله كل عميل متوافق مع OpenAI تحت الغطاء.

curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three names for a fantasy tavern."}
    ],
    "temperature": 0.8,
    "max_tokens": 200
  }'

الرد بصيغة JSON. النص موجود في choices[0].message.content، وأعداد الرموز في usage. مرّر المخرجات عبر jq -r '.choices[0].message.content' إذا كان لديك jq مثبتًا وأردت النص فقط. حقل max_tokens اختياري؛ اتركه خارجًا وقد يستخدم الإكمال ما تبقى من نافذة السياق ذات 100,000 رمز.

نقطة النهاية الأحدث POST /v1/responses متاحة أيضًا إذا كان عميلك يستخدم هذا التنسيق. للمجموعة الكاملة من المعاملات، راجع التوثيق.

2. بث الإجابة

أضف "stream": true وأخبر curl عدم التخزين المؤقت (buffering) باستخدام -N. ستُطبع الرموز (tokens) بمجرد توليدها.

curl -N "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Count from one to ten in words."}]
  }'

تبدأ كل سطر بـ data: وتحتوي على جزء صغير من JSON يحتوي على delta. تحمل الأحداث الأخيرة بيانات الاستخدام، وينتهي البث المتدفق بـ data: [DONE]. بدون -N، ينتظر curl اكتمال المخزن المؤقت، فتبدو البيانات وكأنها تصل دفعة واحدة. لاحظ أن الطلب الذي يستخدم البث المتدفق يشغل أحد فتحات الطلبات المتزامنة حتى ينتهي.

3. اطلب JSON

للحصول على مخرجات يمكن لبرنامج نصي تحليلها، فعّل وضع JSON باستخدام response_format. اذكر كلمة JSON في الموجّه حتى يعرف النموذج الشكل المتوقع.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [{"role": "user",
      "content": "Return JSON with keys name and level for a fantasy character."}]
  }' | jq -r '.choices[0].message.content | fromjson'

يحلل الفلتر النهائي fromjson السلسلة داخل content، لذا يفشل jq بشكل صريح إذا أعاد النموذج شيئًا ليس JSON صالحًا. مما يجعله اختبارًا سريعًا مفيدًا. تتوفر المزيد من الأنماط في صفحة وضع JSON.

4. جرّب استدعاء الأداة

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

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }' | jq '.choices[0].message.tool_calls'

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

5. تحقق من الرؤوس والرصيد

أضف -i لرؤية رؤوس الاستجابة إلى جانب الجسم. ستجد X-Request-Id، X-Balance-USD، X-RateLimit-Limit-Requests و X-RateLimit-Limit-Concurrency.

curl -s -i "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
  | grep -i "^x-"

curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"

تُعيد المكالمة الثانية رصيدك مباشرة. يمكن لأدوات على غرار OpenAI استخدام GET /v1/dashboard/billing/credit_grants بدلاً من ذلك. تكلف طلب صغير مثل الطلب أعلاه جزءاً من سنت واحد: مع 10 رموز مدخلات و5 رموز مخرجات، يكون السعر 10 × 0.15 / 1,000,000 + 5 × 0.50 / 1,000,000 = $0.000004. انظر صفحة الأسعار لمعرفة المعدلات.

سكربت اختبار أولي قابل لإعادة الاستخدام

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

set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"

echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'

echo "chat:"
curl -sf "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
  | jq -r '.choices[0].message.content'

echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"

تجعل علامة -f curl يخرج بخطأ عند فشل HTTP، وset -e يوقف السكربت عندئذٍ. ضعه في مهمة cron أو خطوة CI إذا كنت تشغل خدمة على واجهة هذه API وتريد تحذيراً مبكراً عند حدوث تغيير. احتفظ بالمفتاح في متجر أسرار أو متغير بيئة، وليس في ملف السكربت نفسه.

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

قراءة الأخطاء من curl

الحالةالسبب المحتملالحل
401مفتاح مفقود أو غير صحيحتحقق من رأس Authorization وتأكد من أن $API_KEY مُصدَّر
400JSON مشوه أو حقل غير صالحتحقق من الجسم باستخدام jq . قبل الإرسال
429، الرمز rate_limitedأكثر من 300 طلب في الدقيقة (60 في المفتاح التجريبي)أبطئ حلقة التكرار
429، الرمز concurrencyأكثر من 8 طلبات في وقت واحد (2 في المفتاح التجريبي)شغّل عدد أقل من الوظائف المتوازية
429 مع Retry-After: 5حمل زائد مؤقتانتظر 5 ثوانٍ وأعد المحاولة

أضف -w "\n%{http_code}\n" لطباعة رمز الحالة بعد الجسم، مما يوفر عليك التخمين. تكون أخطاء الجسم بصيغة JSON مع رسالة ورمز، لذا يُظهر jq .errorها بوضوح. إذا رأيت خطأ 429 في حلقة تكرار، فلا تعيد المحاولة فوراً؛ فانتظار بضع ثوانٍ يسمح بتفريغ نافذة الدقيقة وخانات التزامن، بينما تحافظ حلقة إعادة المحاولة الضيقة على تجاوزك للحدّ. المفتاح التجريبي لديه حدود أشد صرامة من المفتاح الكامل، لذا قد يفشل النص البرمجي الذي يعمل بعد شحن الرصيد الأولي عند استخدام الرصيد التجريبي إذا كان يشغّل مهاماً متزامنة. بمجرد استقرار الطلبات، انتقل إلى SDK؛ حيث تنتقل نفس URL واسم النموذج دون تغيير. يمكن للحسابات الجديدة المطالبة بـ $0.50 من الرصيد التجريبي بنقرة واحدة، وهو ما يكفي لمئات من مكالمات الاختبار الصغيرة. تبدأ الشحنات بعد ذلك من $20 وتُدفع بالعملات المشفرة (USDT على TRC20 أو USDC على Base).

أسئلة وأجوبة

إلى أي URL أرسل طلبات curl؟

استخدم https://api.uncensoredllmapi.com/v1 كأساس، ثم أضف /chat/completions أو /responses أو /models أو /balance اعتماداً على ما تحتاجه.

كيف أختبر استدعاء الدوال باستخدام curl؟

أضف مصفوفة tools مع تعريف دالة إلى جسم طلب إكمال المحادثة. إذا قرر النموذج استدعاءها، يحتوي الرد على tool_calls، وترسل النتيجة مرة أخرى كرسالة مع role tool.

لماذا لا يظهر curl شيئاً حتى ينتهي الرد؟

على الأرجح تقوم بالبث المتدفق بدون علامة -N. أضف -N ليقوم curl بطباعة كل قطعة مع وصولها.

هل يكلف الطلب الفاشل مالاً؟

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

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

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