وثائق واجهة برمجة تطبيقات Iymau

المصادقة ومفاتيح API

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

Copycurl https://api.iyamau.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

الطلب الأول باستخدام نقطة نهاية إكمالات المحادثة

أرسل طلب POST إلى نقطة نهاية إكمال الدردشة لتوليد النص. استخدم عنوان URL الأساسي المقدم في لوحة التحكم لضمان التوافق مع العملاء القياسيين. معرف النموذج هو دائمًا "uncensored" لهذه الخدمة المخصصة. يمكنك ضبط معلمات مثل درجة الحرارة وtop_p للتحكم في الإبداع. يقبل النظام حمولات JSON القياسية للنصوص والرسائل. الأخطاء لا تستهلك رصيدك المدفوع مسبقًا. يعمل هذا النهج مع أي SDK متوافق مع OpenAI تفضله.

Copyfrom openai import OpenAI

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

التكامل مع عملاء Node.js

استخدم مكتبة Node.js SDK الرسمية أو أي مكتبة متوافقة للتفاعل مع الواجهة البرمجية. قم بتكوين العميل بعنوان URL الأساسي ومفتاح API الخاص بك. يستجيب النموذج غير المقيد لتنسيقات الرسائل القياسية. يمكنك إرسال عدة أدوار في طلب واحد لسياق المحادثة. يحتوي كائن الاستجابة على النص المولد وإحصائيات الاستخدام. يدعم البث (Streaming) لتسليم الرموز في الوقت الفعلي. تضمن هذه الطريقة زمن استجابة منخفض لتطبيقاتك. تتعامل الخدمة بالأعمال الشاقة على خوادمنا.

Copyimport OpenAI from "openai";

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

الاستجابات التدفقية وSSE

فعّل التدفق عن طريق تعيين المعلمة stream إلى true. تتلقى أحداث الإرسال الخادم (SSE) لكل رمز يتم توليده. يتيح ذلك العرض الفوري للنص أثناء إنتاجه. تحتوي القطعة الأخيرة على إجمالي استخدام الرموز للطلب. هذه الميزة مثالية لواجهات الدردشة والتطبيقات المباشرة. يقلل ذلك من زمن الانتظار المُدرَك للمستخدمين النهائيين. يمكنك تحليل كائنات JSON في كل حدث SSE. يدعم النموذج غير الخاضع للرقابة هذا البروتوكول القياسي بكفاءة.

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)

المعلمات: درجة الحرارة وtop_p ووضع JSON

تحكّم في سلوك التوليد باستخدام المعاملات القياسية. اضبط درجة الحرارة لضبط العشوائية، حيث تزيد القيم الأعلى من الإبداع. استخدم top_p لتصفية توزيع المفردات. فعّل وضع JSON عن طريق ضبط response_format على json_object للبيانات المهيكلة. يلتزم النموذج غير الخاضع للرقابة بهذه القيود بشكل موثوق. يمكنك أيضًا تحديد تسلسلات stop لإيقاف التوليد مبكرًا. تتيح قيم البذرة (Seed) نتائج قابلة للتكرار أثناء الاختبار. تمنحك هذه الخيارات تحكمًا دقيقًا في جودة المخرجات.

حدود المعدل، الحصص، والأخطاء الشائعة

تفرض الـ API حدًا قدره 300 طلب في الدقيقة لكل مفتاح. يمكنك إجراء ما يصل إلى 8 طلبات متزامنة في وقت واحد. يجب ألا يتجاوز جسم كل طلب 8 ميجابايت. إذا تلقيت خطأ 401، تحقق من صلاحية مفتاح API الخاص بك. يشير الخطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً؛ قم بشحن الرصيد عبر العملات المشفرة للمتابعة. يعني خطأ 429 أنك وصلت إلى حد معدل الطلب. انتظر بضع ثوانٍ قبل إعادة المحاولة. تدعم نافذة السياق 100,000 رمز إجمالاً. هذا يسمح بمعالجة مستندات شاملة أو محادثات طويلة.