وثائق واجهة برمجة تطبيقات متوافقة مع OpenAI

عنوان URL الأساسي والمصادقة

عنوان URL الأساسي لجميع الطلبات هو HTTPS://api.keyapikimi.com/v1. قم بالمصادقة عن طريق تمرير مفتاح API الفريد الخاص بك في رأس المصادقة (Authorization header). تتلقى هذا المفتاح فوراً بعد التسجيل باستخدام حساب Google أو البريد الإلكتروني. يمنح المفتاح الوصول إلى النموذج غير المقيد دون اشتراك شهري مطلوب.

Copycurl https://api.keyapikimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch weather in tokyo"}]
  }'

يظل مفتاح API الخاص بك نشطًا حتى تقوم باستبداله. لا تستهلك الأخطاء والرفضات رصيدك المدفوع مسبقًا. يتم الحفاظ على الخصوصية لأن النصوص لا تُستخدم لتدريب بياناتك.

الطلب الأول: إكمالات المحادثة

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

Copyfrom openai import OpenAI

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

يدعم كل طلب نافذة سياق بحجم 100,000 رمز لكل من المدخلات والمخرجات معًا. يمكنك تدفق الاستجابات أو استقبالها ككتلة واحدة. يتعامل النموذج مع استدعاء الوظائف ووضع JSON بكفاءة.

تكامل SDK Node.js

استخدم SDK الرسمي من OpenAI لـ Node.js للاتصال بسهولة. اضبط عنوان URL الأساسي ومفتاح API في كائن التكوين الخاص بك. يعمل هذا النهج مع أي مكتبة عميل متوافقة مع OpenAI. تتجنب منطق التوجيه المعقد باستخدام مزود نموذج واحد.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapikimi.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" للتأكد من أن الطلبات تصل إلى الخادم الصحيح. تتعامل واجهة برمجة التطبيقات مع عد الرموز والفواتير تلقائيًا. تُرجع الأخطاء كرموز حالة HTTP قياسية لسهولة التصحيح.

استجابات البث عبر SSE

فعّل التدفق عن طريق تعيين معلمة stream إلى true. تُعيد واجهة برمجة التطبيقات أحداث مُرسلة من الخادم (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)

تحليل أحداث SSE لعرض النص أثناء توليده. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. إذا لم تضبط max_tokens، فإن القيمة الافتراضية هي 2,048 رمزًا. يعمل التدفق مع جميع المعلمات القياسية مثل تسلسلات التوقف.

المعلمات: درجة الحرارة وTop P

تحكّم في الإبداع باستخدام معلمة درجة الحرارة. تنتج القيم الأعلى نصوصًا أكثر تنوعًا. استخدم top_p للحد من أخذ العينات إلى الرموز الأكثر احتمالًا. يوقف المعلمة stop التوليد عند ظهور سلاسل محددة. تعمل هذه الإعدادات معًا للتحكم الدقيق.

اضبط البذرة للحصول على نتائج قابلة للتكرار أثناء الاختبار. تساعد عقوبات الحضور والتردد في تقليل التكرار. يجبر وضع JSON المخرجات لتكون JSON صالحاً. استخدم response_format لفرض هياكل بيانات صارمة لتطبيقاتك.

حدود، أخطاء، ونافذة السياق

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

التعامل مع HTTP 401 للمفاتيح غير الصالحة. يشير HTTP 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. يعني HTTP 429 أنك وصلت إلى حد معدل الطلب. لا ينتهي الرصيد، لذا يمكنك الشحن في أي وقت عبر العملات المشفرة. لا تُصدر استرداداً للرصيد المستخدم.