البدء السريع لمستخدمي Cursor

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

قم بتكوين العميل ليشير إلى https://api.cursorapikey.com/v1. تتوقع الخدمة رموز المصادقة القياسية لـ OpenAI. أنشئ مفتاحك في صفحة الحصول على مفتاح API؛ ستحتاجه لكل طلب. استخدم معرف النموذج uncensored للوصول إلى النموذج الوحيد المتاح. هذا الإعداد يعمل مع أي مكتبة أو وكيل متوافق مع OpenAI مثل Cursor وClaude Code أو نقاط النهاية المخصصة لـ GitHub Copilot.

الطلب الأول

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

Copycurl https://api.cursorapikey.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."}]
  }'

الطلبات التي تتجاوز 8 MB أو 300 طلب في الدقيقة قد تعيد أكواد أخطاء محددة. تحقق من قسم حدّ المعدل للتفاصيل.

تكامل مكتبة Python

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

Copyfrom openai import OpenAI

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

قم بتهيئة عميل Node.js لـ OpenAI بعنوان URL الأساسي المخصص. مرر مفتاح API من متغيرات البيئة. مطلوب معرف النموذج uncensored لجميع الإكمالات. هذا الإعداد مثالي للوكلاء المبنين على Node أو الوظائف الخالية من الخادم التي تتطلب مساعدة ذكاء اصطناعي متسقة.

Copyimport OpenAI from "openai";

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

تحقق من بيانات الاعتماد الخاصة بك قبل إجراء طلبات جماعية لتجنب أخطاء 402 غير الضرورية.

استجابات البث المتدفق

فعّل البث المتدفق عن طريق تعيين 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)

يحتوي كل جزء على محتوى جزئي. اجمع هذه لتشكيل الاستجابة النهائية.

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

تبلغ نافذة السياق 100,000 رمز (token) للموجّه والإجابة معاً. حدّ المعدل هو 300 طلب في الدقيقة لكل مفتاح. إذا أعدت توليد مفتاحك، يُسحب القديم فوراً. يشير خطأ 401 إلى مفتاح غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. يشير خطأ 429 إلى تجاوز حدّ المعدل. الرصيد لا ينتهي صلاحيته أبداً. خيارات شحن الرصيد تشمل العملات المشفرة (USDT أو USDC).