عنوان URL الأساسي والمصادقة
يعيش الـ API الخاص بنا عند https://api.huggingfacellmapi.com/v1. تقوم بالمصادقة باستخدام رمز حامل مرسل في Authorization رأس. أنشئ مفتاحك فوراً عبر احصل على مفتاح API صفحة باستخدام Google أو البريد الإلكتروني. احفظ هذا المفتاح بأمان؛ فأي شخص يملكه يمكنه إنفاق رصيدك المدفوع مسبقاً. إذا فقدته، أنشئ مفتاحاً جديداً لاستبدال المفتاح النشط القديم. لا يتطلب الأمر رقم هاتف للبدء.
الطلب الأول باستخدام cURL
أرسل حمولة JSON خام لاختبار نقطة النهاية مباشرة. استخدم معرف النموذج uncensored تجاوز المرشحات القياسية. يوضح أمر cURL التالي طلب توليد نص أساسي.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'يعيد هذا كائن JSON يحتوي على النص المُولّد. تحقق من choices مصفوفة للمحتوى الفعلي. إذا تلقيت خطأ 401، تحقق من صحة المفتاح ونشاطه.
تكامل واجهة برمجة تطبيقات Python
استخدم الرسمي openai مكتبة Python للحصول على واجهة نظيفة. وجه العميل إلى عنوان URL الأساسي الخاص بنا واضبط مفتاح واجهة التطبيقات الخاصة بك. تتعامل هذه الطريقة مع إعادة المحاولة وتحليل JSON تلقائيًا.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)ثبّت الحزمة عبر pip. يمكنك بعد ذلك استدعاء نقطة نهاية إكمال الدردشة كما تفعل مع OpenAI. يمنحك كائن الاستجابة إمكانية الوصول إلى استخدام الرموز المميزة وأسباب الإنهاء.
إعداد عميل Node.js
يمكن لمطوري JavaScript استخدام openai حزمة Node. قم بتكوين العميل بعنوان URL الأساسي المحدد الخاص بنا. يضمن ذلك توجيه جميع الطلبات عبر خوادمنا غير المقيدة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);شغّل هذا المقتطف في بيئة Node الخاصة بك. يوضح استدعاء متزامناً بسيطاً. يمكنك دمجه بسهولة في مسارات Express أو الوظائف الخالية من الخوادم.
استجابات البث
فعّل البث عن طريق تعيين stream: true. يرسل الخادم أحداث الحدث المرسلة من الخادم (SSE) التي تحتوي على رموز مميزة جزئية. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين النهائيين.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)تحليل كل قطعة عند وصولها. تحتوي القطعة الأخيرة على إجمالي استخدام الرموز للطلب. هذا مفيد لبناء واجهات الدردشة التي تكتب الاستجابات في الوقت الفعلي.
حدود، أخطاء، والسياق
نافذة السياق هي 100,000 رمز للجمع بين النص المدخل والإخراج. يمكنك طلب ما يصل إلى 16,000 رمز إخراج. تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 عدم كفاية الرصيد. تحد حدود معدل الطلب من 300 طلب في الدقيقة. سيتم رفض الطلبات التي يتجاوز حجمها 8 ميجابايت. الأخطاء أثناء المعالجة لا تستهلك رصيدك.
