دليل البدء السريع للمطورين

المتطلبات الأساسية: مفتاح API الخاص بك

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

تكوين Cursor للتوافق مع OpenAI

وجّه عميلك إلى نقطة النهاية المحددة لضمان التوجيه الصحيح. اضبط عنوان URL الأساسي على HTTPS://api.keyapicursor.com/v1 وأدرج مفتاحك في رأس المصادقة. يعمل هذا الإعداد مع أي SDK متوافق مع OpenAI دون تعديل اسم النموذج. يجب عليك تحديد معرف النموذج على أنه uncensored لتلقي الإخراج ذي الأوزان المفتوحة.

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

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

معالجة استجابات التدفق

قم بتدفق الرموز لانخفاض زمن الاستجابة المُدرَك في التطبيقات التفاعلية. يرسل الخادم أحداث الإرسال عبر الخادم التي تحتوي على أجزاء جزئية حتى تتضمن الكتلة الأخيرة بيانات الاستخدام الإجمالي. قم بتحليل هذه الأحداث لتحديث واجهة المستخدم الخاصة بك في الوقت الفعلي. تعمل هذه الطريقة بشكل متطابق عبر عملاء Python و Node.

الدمج مع أدوات SDK الخاصة بـ Python و Node

أعد استخدام مكتلات التعليمات البرمجية القائمة عن طريق تعديل معلمات عنوان URL الأساسي والمفتاح فقط. يوضح مقتطف Python التكامل المباشر مع مكتبة العميل الرسمية. يتبع مثال Node نفس النمط لبيئات JavaScript. تدعم كلتا الطريقتين وضع JSON واستدعاء الوظائف افتراضياً.

فهم حدود معدل الطلبات والرموز

راقب حجم طلباتك لتجنب انقطاع الخدمة أثناء الاستخدام الثقيل. يفرض النظام حدًا بـ 300 طلب في الدقيقة لكل مفتاح. يمكنك تشغيل ثمانية طلبات متزامنة في وقت واحد بحد حجم جسم 8 MB. الأخطاء مثل مفاتيح 401 غير الصالحة أو رصيد 402 غير الكافي لا تستهلك رصيدك المدفوع مسبقًا.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)