دليل تكامل Cursor: واجهة برمجة تطبيقات متوافقة مع OpenAI

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

يستخدم Cursor مفتاح API الخاص بك لتوجيه الطلبات إلى نقطة النهاية المستضافة لدينا. استبدل عنوان URL الأساسي القياسي لـ OpenAI بنطاقنا المحدد لتمكين التوليد غير الخاضع للرقابة دون تعديل كود العميل. تتلقى مفتاحًا نشطًا واحدًا لكل حساب، يمكنك إنشاؤه فورًا عبر تسجيل الدخول باستخدام Google أو البريد الإلكتروني.

قم بتكوين متغير البيئة أو إعدادات IDE الخاص بك للإشارة إلى HTTPS://api.cursoropenaiapikey.com/v1. معرف النموذج هو ببساطة "uncensored". يضمن هذا الإعداد تجاوز كل طلب لمرشحات المحتوى الافتراضية مع الحفاظ على التوافق الكامل مع التكاملات الحالية.

عنوان URL الأساسي هو HTTPS://api.cursoropenaiapikey.com/v1. مرر مفتاحك في رأس المصادقة كرمز حامل (Bearer token). تعمل هذه الطريقة مع أي عميل متوافق مع SDK OpenAI.

• عنوان URL الأساسي: HTTPS://api.cursoropenaiapikey.com/v1
• معرف النموذج: uncensored
• المصادقة: رمز حامل في الرأس

إجراء أول طلب

أرسل طلب إكمال محادثة قياسي للتحقق من الاتصال والفوترة. تقبل نقطة النهاية لدينا نفس بنية JSON الخاصة بـ OpenAI، مما يضمن التوافق الفوري مع نصوصك الحالية. يعيد الاستجابة النص المُولّد مع مقاييس استخدام الرموز المميزة.

استخدم أمر cURL التالي لاختبار النقطة النهائية. استبدل YOUR_API_KEY بالمفتاح المُولّد من لوحة التحكم. يتضمن الطلب نظام توجيه بسيط لإظهار القدرة غير المقيدة.

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

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

تكامل واجهة برمجة تطبيقات Python

استخدم مكتبة بايثون الرسمية من OpenAI مع عنوان URL أساسي مخصص للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. يتيح لك هذا النهج الاستفادة من قواعد الشيفرة الموجودة دون إعادة كتابة منطق العميل. قم بتعيين عنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات قبل تهيئة العميل.

قم بتهيئة العميل باستخدام بيانات الاعتماد الخاصة بك وعنوان URL الأساسي الصحيح. ثم اتصل بـ chat.completions.create مع معرف النموذج "uncensored". يوفر كائن الاستجابة الوصول إلى المحتوى المولد وإحصائيات الاستخدام.

Copyfrom openai import OpenAI

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

تضمن هذه الطريقة التوافق مع سير عمل Python القياسي. يمكنك تمرير معلمات إضافية مثل درجة الحرارة أو تسلسلات التوقف للتحكم في التوليد. تتعامل مكتبة SDK مع التسلسل الهرمي وتحليل الاستجابة تلقائياً.

تكامل SDK Node.js

قم بدمج حزمة Node.js OpenAI لإرسال الطلبات من تطبيقات JavaScript أو TypeScript الخاصة بك. قم بتكوين العميل مع عنوان URL الأساسي الخاص بنا لتمكين التوليد غير الخاضع للرقابة. يعمل هذا الإعداد بسلاسة مع مشاريع Node الموجودة.

أنشئ مثيلًا جديدًا لعميل OpenAI بمفتاح API الخاص بك وعنوان URL الأساسي الصحيح. ثم استدعِ طريقة chat.completions.create. توفر الاستجابة النص المُنشأ وبيانات استخدام الرموز المميزة.

Copyimport OpenAI from "openai";

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

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

استجابات البث

تمكين التدفق لتلقي الرموز كما يتم إنشاؤها. يقلل هذا من زمن الاستجابة المُدرَك لعمليات البرمجة والتطبيقات التفاعلية. ترسل واجهة برمجة التطبيقات أحداث الإرسال من الخادم (SSE) مع كل رمز.

عيّن معلمة stream إلى true في طلبك. ستشمل الاستجابة شرائح متعددة. يتم تضمين مقاييس استخدام الرموز في الشريحة الأخيرة لتجنب تناقضات الفوترة. هذه الطريقة مثالية لواجهات المستخدم في الوقت الفعلي.

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)

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

حدود المعدلات ونافذة السياق

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

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

• حد معدل الطلبات: 300 طلب/دقيقة
• الطلبات المتزامنة: 8
• نافذة السياق: 100,000 رمز
• الحد الأقصى للإخراج: 16,000 رمز مميز