Hermes API: غيّر عميلك في ثلاثة أسطر

تثبيت SDK من OpenAI

بما أن نقطة النهاية لدينا متوافقة مع OpenAI، يمكنك استخدام SDKs الرسمية التي تعرفها بالفعل. يتيح لك هذا النهج التبديل من موردين آخرين دون إعادة كتابة منطق التطبيق. ندعم حزمة openai القياسية لبيئات Python و Node.js.

تأكد من استخدام إصدار حديث من SDK لضمان التوافق مع ميزات البث المتدفق واستدعاء الدوال. تتعامل مكتبة العميل مع تسلسل JSON والنقل عبر HTTP تلقائيًا، لذا يمكنك التركيز على معلمات النموذج بدلاً من تفاصيل الشبكة.

تكوين URL الأساسي والمفتاح

يتم المصادقة عبر رمز Bearer في رأس Authorization. تحصل على مفتاحك عبر التسجيل باستخدام بريد إلكتروني وكلمة مرور في لوحة التحكم. لا يتطلب الأمر بطاقة ائتمان للتجربة، ويمكنك تجديد مفتاحك في أي وقت لإلغاء الوصول.

عيّن عنوان URL الأساسي إلى نقطة النهاية المخصصة لدينا. يضمن ذلك توجيه جميع الطلبات إلى بنية النموذج بدون رقابة الخاصة بنا بدلاً من السحابة الافتراضية لـ OpenAI. يمكنك العثور على مفتاح API الخاص بك في صفحة 'الحصول على مفتاح API' مباشرة بعد التسجيل.

أرسل طلبك الأول

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

• استخدم POST /v1/chat/completions لتوليد النصوص.
• تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه بالإضافة إلى الإكمال.
• يتم تحميل الطلبات بناءً على عدد رموز الإدخال والإخراج.

Copycurl https://api.hermesllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

تمكين البث المتدفق (SSE)

لتحسين تجربة المستخدم، فعّل البث المتدفق لتلقي الرموز بمجرد توليدها. يقلل هذا من زمن الاستجابة المدرك، خاصة للاستجابات الأطول. يعيد الخادم أحداثًا مرسلة من الخادم (SSE) التي يمكن لعميلك تحليلها في الوقت الفعلي.

عيّن المعلمة stream إلى true في جسم الطلب. سيقوم الـ SDK بإرجاع قطع البيانات مع وصولها. هذا مفيد بشكل خاص لواجهات الدردشة حيث تريد عرض النص تدريجياً بدلاً من الانتظار حتى انتهاء الاستجابة الكاملة.

Copystream = 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)

استخدام استدعاء الأداة/الدالة

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

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hermesllmapi.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);

فحص النماذج المتاحة

استعلم عن نقطة النهاية للنماذج للتحقق من الاتصال ورؤية الخيارات المتاحة. حالياً، نقدم نموذجاً مخصصاً واحداً: uncensored. تتجنب هذه البساطة تعقيد توجيه النماذج أو البنية التحتية العامة، مما يضمن سلوكاً قابلاً للتنبؤ.

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hermesllmapi.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)

معالجة حدود المعدل والأخطاء

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

تشمل الأخطاء الشائعة 401 (مفتاح غير صالح) و 402 (رصيد غير كافٍ). الرصيد المسبق الدفع لا ينتهي، لذا يمكنك الشحن حسب راحتك. يتم تطبيق مكافآت الرصيد تلقائيًا للشراءات الأكبر: +5% من $50 و +10% من $100.